为 什么 要 翻译 这 本 书 
物 联网 的 兴起 推动 着 越 来 越 多 的 嵌入 式 设 备 投入 使 用 ， 从 普通 的 家 用 设备 到 用 于 提供 治安 监控 、 交 通 流 控 等 公共 服务 的 设备 ， 其 中 的 核心 之 一 就 是 
藤 入 式 操作 系统 。 而 Linux 正 成 为 越 来 越 多 藤 入 式 开 友 者 的 首选 。 


市 面 上 不 缺乏 适用 于 各 种 开发 语言 的 开发 、 编 译 和 打包 工具 ， 但 在 Yocto 项 目 出 现 前 ， 这 些 零 散 的 工作 需要 窜 入 式 开 发 者 自己 串 起 来 以 交付 最 终 的 谋 
入 陈 系 统 。Yocto 项 目 恰 好 解决 了 这 些 问 题 ， 它 是 很 多 工具 的 有 机 整合 ， 可 以 让 诅 入 式 开 友 者 更 容易 且 更 局 效 地 交付 误 入 陈 系 统 。 


本 书 束 是 专注 于 讲解 Yocto 项 目的 实战 手册 。 书 中 从 一 开始 束 强 调 “ 动 手 实验 ”的 重要 性 ， 鼓 励 读者 跟着 里 面 的 例子 动手 做 起 来 ， 最 终 完全 了 解 整个 
过 程 并 知道 每 个 步骤 需要 注意 什么 。 


另外 ， 本 书 也 讲解 了 如 何在 嵌入 式 系 统 开 友 和 交付 过 程 中 管理 许可 及 合 规 性 。 在 强调 知识 产权 的 今天 ， 这 一 点 的 重要 性 也 不 言 而 喻 。 


Yocto 项 目 社 区 经 理 、 本 书 英 文 原版 技术 审 稿 人 Jeffrey Osier-Mixon 在 亚马逊 网 站 (https://www.amazon.com/gp/customer- 
reviews/R20UE23XPGTB7Y/ref=cm cr arp d rvw ttl?ie=UTF8&ASIN=0133443248) 对 本 书评 论说 : “该 书 非常 细致 地 解释 了 系统 的 各 个 工具 和 组 
件 是 如 何 相 互 适应 的 ， 从 整体 构建 工具 BitBake 及 其 操作 的 菜谱 (元 数据 ) 开始 ， 然 后 深入 系统 经 过 的 各 个 过 程 。 最 有 用 的 是 ， 它 从 开 上 者 的 角度 讲解 构 
建 系 统 ， 涵 盖 了 开发 者 任 构 建 过 程 的 各 个 环节 需要 解决 的 问题 .…. 总 之 ， 本 书 是 了 解 使 用 Yocto 项 目 工具 构建 用 于 典 入 式 系统 的 Linux 之 极 佳 资 源 。 我 非 
常 推荐 。” 简 而 言 之 ， 本 书 是 一 位 有 着 超过 20 年 软件 工程 实践 经 验 的 专家 的 打 易 之 作 ， 它 务实 、 细 致 、 逻 辑 清晰 。 它 不 仅仅 是 一 本 参考 书 ， 更 是 一 本 实 
践 指南 。 


本 书 中 文 版 可 能 是 专注 于 Yocto 项 目的 先驱 性 图 书 ， 希 望 能 对 广大 启 入 式 系 统 开 发 者 有 所 帮助 。 
读者 对 象 

本 书 适 合 以 下 几 类 读者 阅读 : 

“TAKA RL 

RAK ALAA 

HARKS eB 

. 嵌入 式 产 品 合 规 工程 师 


. 计算 机 相关 专业 学 生 


勘误 


虽然 译 者 努力 保证 本 书 翻译 中 不 出 现 错误 ， 但 鉴于 译 者 的 知识 和 能 力 ， 书 中 难免 出 现 用 词 错误 、 适 用 性 等 问题 。 在 此 ， 居 请 读者 不 癌 指教 ， 指 出错 
误 。 请 读者 发 送 邮 件 到 xufengnju@163.com 帮 助 译 者 修正 错误 。 甚 误 将 友 布 在 https://github.com/xufengnju 上 。 
致谢 
感谢 机 械 工 业 出 版 社 华章 公司 引进 了 原 书 的 中 译本 版 权 ， 这 是 本 书 中 文 版 得 以 面市 的 最 重要 条 件 。 感 谢 华 章 公 司 张 志 铭 和 关 敏 老师 ， 你 们 专业 的 编 
辑 能 力 为 本 书 提供 了 重要 的 质量 保证 。 
感谢 我 的 妻子 虽 宁 和 可 爱 的 女儿 稍 欣 ， 谢 谢 你们 的 支持 和 理解 。 
Ay Me 
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芯 入 式 Linux 的 形势 有 点 像 美国 老 西 部 (the Old West) : 不 同 的 技术 前 哨 分 散在 各 处 ， 在 这 些 撤 术 前 哨 乙 间 是 贫 兰 和 往往 十 分 危险 的 形 为。 如果 想 


去 那里 旅行 ， 则 需要 有 充足 的 储备 ， 要 熟悉 地 形 ， 并 且 要 有 可 靠 的 向 导 。 
正如 在 18 世 纪 中 期 淘金 热 期 间 人 们 迁移 到 美国 老 西部 一 样 ， 伴 随 着 物 联网 (Internet of Things, loT) 的 热潮 ， 开 友 者 正在 进入 训 入 陈 Linux 的 世 


界 。 正 如 增加 的 人 口 为 老 西部 市 来 法 律 、 秩 序 和 文明 一 样 ， 重 要 的 新 开源 软件 项 目 正在 为 租 入 式 Linux 市 来 秩序 。 
Yocto 项 目 是 十 分 重要 的 秩序 缔造 者 。 它 的 工具 能 帮 你 主要 关注 设计 项 目 (你 想 要 构建 的 东西 ) 并 且 仪 仅 投 入 最 少 的 必要 时 间 和 精力 来 把 它们 整合 在 


它 将 帮助 你 完成 工作 并 把 物 联网 项 目 市 向 市 场 。 如 果 运 气 不 错 ， 你 将 会 


一 起 (如 何 构 建 你 想 要 的 东西 ) 。 
这 本 书 是 一 个 可 靠 的 向 导 。 通 过 按 逻 辑 排序 并 市 有 清晰 和 完整 说 明 的 章节 


在 一 路 上 收获 快乐 。 
Arnold Robbins 
Prentice Hall 开 源 软 件 开发 系列 编辑 


享受 冒险 吧 ! 


能 篮球 。 欢 迎 来 到 和 


Bb 


~ 
s 


Hab 
= Ab) 


智能 家 居 、 智 能 汽车 、 智 能 手机 、 智 能 电视 、 智 能 恒温 能 电灯 、 智 能 手表 、 先 衣 机 、 智 能 烘 干 机 、 智 能 冰箱 以 及 智 
能 万 物 的 勇敢 新 世界 。 

在 日 常生 活 中 ， 我 们 触及 和 交互 的 几乎 所 有 东西 中 都 有 骨 入 式 计 算 机 ， 它 的 剧 增 ,， 使 得 藤 入 式 系 统 工程 和 骨 入 式 软 件 开发 受到 了 瞩目 。 铅 入 式 系 统 
隐藏 在 其 用 户 的 直接 视线 之 外 ， 它 们 缺少 那些 带 有 浮华 用 户 界 面 的 网 络 应 用 所 具有 的 吸引 力 ， 也 缺少 那些 带 有 动画 和 逼真 图 像 的 计算 机 游戏 所 具有 的 酷 
富 不 奇怪 的 是 ， 计 算 机 科学 专业 的 学 生 和 软件 开 友 者 几乎 不 会 把 嵌入 式 软 件 工程 当成 他 们 的 第 一 职业 选择 。 然 而 ，“ 智 能 万 物 革 命 ” 和 物 联 
语言 和 编程 语言 的 专家 将 受到 雇主 的 追捧 。 


号 


一 一 


酷 的 感觉。 
网 正在 推动 人 们 对 那些 能 够 桥接 硬件 和 软件 世界 的 专业 人 士 的 需求 。 那 些 使 用 电路 原理 图 语 
对 于 爆炸 式 增多 的 骨 入 式 应 用 来 说 ，Linux 已 经 成 为 第 一 选择 。 对 于 这 种 选择 ， 有 很 多 恰当 的 理由 。 我 们 将 在 接 下 来 的 草 节 中 详细 阐述 这 些 理由 。 经 
语言 来 说， 都 不 缺少 优秀 的 开发 工 


历 了 作为 服务 于 各 种 行业 的 从 入 式 软 件 开 上 友 者 的 旅程 ， 我 通过 艰 平 的 方式 学 习 了 散 入 了 式 系 统 的 Linux。 对 几乎 任何 编程 语 
具 。 绝 大 部 分 用 于 Linux 的 库 和 应 用 都 会 由 于 它们 的 工具 化 而 被 简单 原生 地 构建 。 使 用 内 核 目 有 的 构建 系统 ， 即 使 从 头 开 始 构建 Linux 内 核 几 乎 也 是 一 件 


轻而易举 的 事 。 然 而 ， 当 需要 把 所 有 的 东西 整合 进 可 局 动 的 系统 时 ， 选 择 残 很 少 了 
通过 提供 一 套 全 面 的 、 以 OpenEmbedded 构 建 系统 为 中 心 的 集成 化 工具 ，Yocto 项 目 弥 补 了 这 种 鸿沟 。 在 大 约 几 个 小 时 内 实现 从 源 代码 到 可 启动 的 


系统 一 一 我 希望 在 我 开始 使 用 骨 入 式 Linux 的 时 候 会 有 这 样 的 奢侈 。 


本 书 定位 
集成 多 个 不 同 的 必要 步骤 来 从 头 创 建 完全 可 用 的 Linux 操 作 系统 栈 的 构建 系统 是 相当 复杂 的 。 本 书 专注 于 构建 系统 本 身 以 及 如 何 有 效 使 用 它 来 构建 定 
制 的 Linux 发 行 版 。 本 书 不 是 关于 嵌入 式 Linux 的 教程 。 虽 然 第 6 章 解 释 了 Linux 系 统 架构 的 基础 (因为 该 信息 对 于 理解 构建 系统 如 何 组 合 多 个 不 同 的 组 件 


成 为 可 运行 的 系统 是 必要 的 ) ， 但 是 就 点 入 式 Linux 本 身 而 言 ， 不 会 深入 它 的 细节 。 如 果 你 是 蔡 入 式 Linux 开 发 新 手 ， 那 么 强烈 推荐 Christopher Hallinan 
的 好 书 《Embedded Linux Primer》， 该 书 与 本 书 是 同一 系列 从 书 (Prentice Hall 开 源 软 件 开发 系列 ) 。 


在 本 书 中 ， 你 将 会 学 习 OpenEmbedded 构 建 系 统 如 何 工作 、 如 何 编 写 菜 谱 (recipe) 来 构建 你 自己 的 软件 组 件 、 如 何 使 用 和 创建 Yocto 项 目 板 支持 
包 (Board Support Package, BSP) 来 支持 不 同 的 硬件 平台 以 及 如 何 调 试 构建 失败 。 你 还 将 学 习 如 何 为 应 用 开 友 构建 软件 开发 包 ， 以 及 如 何 为 了 无 颖 


的 往返 开发 (round-trip development) 而 把 这 些 开 发 包 和 流行 的 Eclipse 和 集成 开发 环境 (Integrated Development Environment, IDE) 集成 起 来 。 


本 书 读者 
本 书面 向 那些 具有 Linux 实 践 知识 的 软件 开发 者 和 程序 员 。 假 设 你 熟悉 Linux 命 令 行 ， 可 以 使 用 典型 的 工具 (例如 Make 和 C/C++ 编译 器 ) 在 Linux 系 
统 上 构建 程序 ， 还 可 以 阅读 和 理解 基本 的 shell 脚 本 。 


构建 系统 是 完全 用 Python 编 写 的 。 即 使 你 不 是 Python 专 家 也 可 以 使 用 它 ， 并 理解 它 如 何 工 作 ， 但 是 具备 一 些 核心 的 Python 知 识 一 定 是 有 利 的 。 


本 书 内 容 


第 1 章 对 采用 嵌入 式 系统 的 Linux 进 行 简要 介绍 ， 为 众 入 式 Linux 的 形势 和 创建 定制 戏 入 式 发 行 版 的 挑战 的 概览 商定 了 基础 。 
第 2 章 通 过 用 构建 系统 启动 Linux 操 作 系统 栈 的 首次 构建 来 介绍 Yocto 项 目 ， 同 时 也 给 出 了 Yocto 项 目 系列 和 Yocto 项 目 历史 的 概览 。 
第 3 章 解 释 了 构建 系统 的 基础 、 工 作 流 和 架构 。 


第 4 章 解 析 了 BitBake 一 一 处 于 OpenEmbedded 构 建 系统 核心 的 构建 引擎 。 其 中 解释 了 菜谱 (recipe) 的 元 数据 (metadata) 概念 、 类 、 配 置 文件 
及 其 语法 。BitBake 方 式 的 “Hello World” 项 目 说 明了 构建 工作 流 。 通 过 提供 的 信息 ， 你 会 获得 用 于 理解 所 提供 的 菜谱 和 编写 自己 的 菜谱 的 必要 知识 。 


第 5 草 介 绍 了 可 用 于 对 构建 问题 进行 故障 排除 的 工具 和 机 制 ， 并 且 提 供 了 如 何 有 效 使 用 这 些 工具 的 实用 建议 。 


第 6 草 提 供 了 Linux 操 作 系 统 栈 的 基础 ， 并 解释 了 不 同 组 件 是 如 何 分 层 的 。 另 外 还 讨论 了 内 核 空 间 和 用 户 空 间 的 概念 以 及 应 用 程序 如 何 通 过 由 标准 C 库 
提供 的 系统 调用 来 和 Linux 内 核 交互 。 


第 7 章 细致 讲解 了 如 何 使 用 Yocto 项 目 创建 定制 化 的 Linux 友 行 版 。 它 以 构建 系统 可 用 的 Linux 皮 行 版 蓝图 以 及 如 何 定制 它们 的 简要 介绍 作为 开始 。 然 
后 演示 了 如 何 使 用 构建 系统 工具 完全 从 头 创建 Linux 发 行 版 。 读 完 本 章 以 后 ， 你 将 知道 如 何 构 建 自己 的 操作 系统 镜像 。 


第 8 章 解 释 了 BitBake 菜 谱 以 及 如 何 编写 它们 来 用 构建 系统 构建 自己 的 软件 包 。 这 一 草 提供 了 你 可 以 尝试 的 各 种 真实 世界 的 菜谱 例子 。 


第 9 章 仔细 研究 了 用 OpenEmbedded 构 建 系 统 来 构建 Linux 内 核 的 细节 ， 解 释 了 构建 系统 工具 如 何 与 内 核 的 构建 环境 交互 以 设置 内 核 配 置 和 应 用 补 
本 。 本 章 以 天 于 构建 系统 如 何 处 理 树 外 (out-of-tree) 内 核 模块 以 及 合并 构建 设备 树 和 构建 过 程 的 讨论 结束 。 


第 10 章 介绍 了 构建 系统 如 何 支 持 针对 不 同 硬件 的 构建 一 一 也 束 是 说 ， 为 不 同 CPU 架 构 和 系统 构建 。 在 介绍 了 Yocto 项 目 板 支持 包 的 概念 以 后 ， 本 章 
细致 讲解 了 如 何 使 用 板 支 持 包 构 建 项 目 。 然 后 研究 了 Yocto 项 目 板 支持 包 的 内 部 原理 ， 并 用 实际 的 例子 来 解释 如 何 构建 自己 的 板 支 持 包 ， 你 可 以 将 这 个 例 
子 使 用 在 真实 硬件 上 。 本 章 以 为 不 同 硬件 配置 创建 可 局 动 介质 镜像 结束 。 


第 11 章 描述 了 Yocto 项 目 对 开发 应 用 的 支持 ， 这 些 应 用 被 用 在 通过 构建 系统 创建 的 Linux 操 作 系统 栈 上 。 其 中 提供 了 关于 如 何 构建 那些 包含 用 于 往返 
应 用 开 皮 的 全 部 必需 工具 的 应 用 开 友 工具 集 (Application Development Toolkit, ADT) 的 实际 操作 指南 。 示 例 说 明了 如 何 通 过 命令 行 工 具 和 Eclipse 
集成 开发 环境 来 将 应 用 开发 工具 集 用 于 应 用 开发 。 指 南 会 一 步 步 教 你 如 何 远 程 运行 和 调试 真实 硬件 目标 上 的 应 用 。 


第 12 章 讨论 了 对 于 开源 许可 合 规 性 的 要 求 以 及 Yocto 项 目 提供 的 那些 有 助 于 满足 要 求 的 工具 。 


第 13 章 介绍 了 帮助 你 把 Yocto 项 目 扩展 到 团队 的 一 些 工 具 。Toaster 是 基于 Web 的 图 形 用 户 界 面 ， 它 可 用 于 创建 能 从 Web 浏 览 器 远程 控制 的 构建 系 
统 。 构 建 历史 是 提供 追踪 和 审计 能 力 的 工具 。 使 用 源 镜像 ， 你 可 以 共享 源 包 来 避免 重复 的 下 载 ， 并 为 产品 交付 控制 源 版 本 。 最 后 但 并 非 最 不 重要 的 
是 ，Autobuilder 为 自动 化 构建 、 质 量 保证 和 友 布 过 程 提供 了 开 箱 即 用 的 持续 构建 和 集成 框架 。 掌 握 了 本 章 的 知识 后 ， 你 可 以 为 Yocto 项 目 有 效 地 设置 团 
队 环 境 。 


附录 包括 流行 的 开源 许可 ， 以 及 以 字母 排序 的 构建 系统 元 数据 层 和 机 器 的 参考 。 


动手 操作 经 验 


本 书 的 撰写 目的 是 提供 Yocto 项 目的 实际 动手 操作 经 验 。 如 果 依 照 并 且 芝 试 了 相关 示例 ， 那 么 你 会 收获 恨 多 。 它 们 中 的 大 部 分 可 以 依赖 运行 最 
Linux 皮 行 版 的 基于 x86 的 工作 站 来 轻松 完成 〈 详 细 的 需求 会 在 第 2 章 提 供 ) 。 为 了 获得 更 好 的 经 验 ， 要 利用 流行 的 开 友 板 ， 例 如 BeagleBone、 
MinnowBoard Max 或 者 Wandboard。BeagleBone 是 优秀 的 低 成 本 的 实验 平台 。 另 外 两 个 板 提供 更 好 的 性 能 ， 也 让 你 获得 关于 多 核 系统 的 经 验 。 


分 析 代 码 并 且 尝 试 理解 本 书 的 代码 。 遵 特步 邓 O， 然 后 通过 改变 设置 、 应 用 你 自己 的 配置 等 来 完成 自己 的 设计 。 这 是 最 好 的 学 习 方 式 ， 并 且 我 可 以 告 
诉 你 ， 这 也 相当 有 趣 。 让 你 自己 的 第 一 个 Linux 友 行 版 工作 在 你 选择 的 一 个 硬件 上 是 很 棒 的 体验 。 


致谢 
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一 一 化 费 在 实验 上 的 时 间 、 找 到 最 好 的 让 它们 工作 的 方法 以 及 以 简洁 和 可 理解 的 方式 文档 化 所 有 事物 。 在 这 个 过 程 中 ， 要 真心 感谢 很 多 作者 和 技术 撰 稿 
人 的 工作 一 一 我 已 经 阅读 过 很 多 并 且 正 在 持续 阅读 他 们 的 书籍 和 手册 。 

首先 ， 对 我 的 家 庭 ， 包 括 我 挚爱 的 妻子 Janan 和 3 个 非常 棒 的 儿子 Dominic、Daniel 和 Jonas 表 示 感 谢 。 如 果 没有 他 们 的 支持 和 理解 ， 我 是 不 可 能 在 
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特别 感谢 Yocto 项 目 团队 。 当 我 接触 彼 时 还 是 Yocto 项 目 项 目 经 理 的 Dave Stewart 和 Yocto 项 目 社区 经 理 的 Jeffrey Osier-Mixon 时 ， 他 们 立刻 对 写 
作 本 书 的 主意 表示 欢迎 并 且 提 供 了 支持 。 这 个 团队 的 一 些 人 在 给 予 建议 和 问题 解答 方面 特别 有 帮助 : Beth Flanagan 对 Autobuilder 方 面 、Belen Barros 
Pena 和 Ed Bartosh 对 Toaster 方 面 以 及 Paul Eggleton 和 Khem Raj 对 我 提交 到 Yocto 项 目 邮件 列表 里 面 的 问题 提供 的 参考 。 


特别 感谢 撰写 了 《Embedded Linux Primer: A Practical Real-World Approach) (Prentice Hall,2006) 的 Christopher Hallinan。 他 写 的 这 本 
书 激 发 了 我 创作 关于 Yocto 项 目的 书 的 欲望 。 


特别 感谢 总 策划 编辑 Debra Williams Cauley， 感 谢 她 的 指导 ， 特 别 是 在 本 书写 作 过 程 中 付出 的 耐心 。 本 书 花费 了 远 超 预 期 的 时 间 ， 而 我 是 唯一 需要 
为 本 书 错过 交 稿 期 限 负责 的 人 。 


人 怎么 感谢 和 表扬 本 书 专注 的 审核 团队 都 不 为 过 ， 他 们 是 Chris Zahn, Jeffrey Osier-Mixon, Robert Berger 和 Bryan Smith。 感 谢 他 们 的 纠 错 及 改 


进 建 议 ， 这 保证 了 本 书 的 质量 。 
我 也 想 感谢 Prentice Hall 的 生产 团队 一 一 Julie Nahil 和 Anna Popick， 感 谢 他 们 的 协调 和 指导 工作 ， 特 别 是 Carol Lallier 在 编辑 原稿 过 程 中 的 勤 揭 。 


还 要 感谢 Linux 基 金 会 和 Jerry Cooperstein， 他 们 给 了 我 开发 Linux 基 金 会 的 天 于 Yocto 项 目的 培训 课程 的 机 会 。 没 有 什么 方法 比 教 别 人 更 利于 学 
习 。 感 谢 我 教 过 的 学 生 。 通 过 他 们 的 宇 贵 提问 和 反馈 ， 我 获得 了 大 量 对 于 学 生 用 肉 入 式 Linux 开 发 产品 时 遇 到 的 很 多 不 同 问题 的 理解 。 他 们 问 得 最 多 的 问 
题 是 : “有 没有 一 本 天 于 Yocto 项 目的 书 ”” 终 于， 我 可 以 回答 : “有 的 。 ” 


第 1 草 ”用 于 髓 入 式 系 统 的 Linux 


物 联 网 (Internet of Things) 正 激发 着 梦想 家 们 的 想象 灵感 ， 也 激发 着 工程 师 们 的 创造 性 。 作 为 由 巨大 数量 的 实时 收集 、 分 析 和 传递 数据 的 互联 设 
备 组 成 的 统一 计算 网 络 ， 物 联网 承载 着 新 的 信息 拉 术 时 代 的 希望 。 


组 成 物 联网 的 设备 需要 满足 一 套 全 新 的 需求 并 且 提 供 原来 嵌入 式 系 统 中 不 存在 的 功能 性 。 连 通 性 ， 包 括 通 过 蜂窝 数据 网 络 连 通 ， 是 一 个 明显 的 需 
求 ， 其 他 还 有 远程 管理 、 软 件 配置 和 更 新 、 能 耗 效率 以 及 长 的 寿 合 ， 当 然 还 有 安全 性 ， 仪 举 几 例 。 


正在 改变 的 嵌入 式 系 统 的 形势 需要 新 的 方法 来 构建 操作 这 种 新 的 互联 硬件 的 软件 栈 。 


1.2 ERATÈLinuxf A 


从 入 陈 系统 是 多 种 多 样 的 。 种 类 繁多 的 硬件 不 可 避免 地 市 来 了 软件 适用 性 的 负担 ， 最 显著 的 是 操作 系统 ， 操 作 系 统 通过 它 的 库 和 应 用 程序 编程 接口 
(Application Programming Interface, API) 提供 了 对 硬件 的 抽 儿 。 没 有 一 孝 永 逸 的 方案 ， 而 你 ， 作 为 系统 工程 师 ， 将 必须 为 戏 入 陈 Linux 项 目 选 择 


IANO 


fix BREE, FEES WRAL RI AFR Bis. PRESUME, SPAR —ER BEERS FS (Operating 
System Vendor, OSV) 的 商业 肉 入 式 Linux 产 品 。 


1.2.1 #RAZCLINUXA THK 


与 梨 面 版 和 服务 器 Linux 友 行 版 类 似 ， 不 断 友 展 的 散 入 陈 Linux 上 帮 行 版 被 社区 项 目 和 商业 操作 系统 厂商 开 上 友 出 来 。 其 中 一 些 宏 定 位 为 针对 特定 类 型 的 
藤 入 式 系 统 和 设备 ， 而 其 他 的 在 本 质 上 是 更 通用 的 ， 意 在 提供 一 个 基础 而 非 完整 的 系统 。 


Android 


尽管 Android (www.android.com、http://developer.android.com 和 http://source.android.com) 的 主要 目标 是 手机 和 平板 计算 机 ， 但 是 它 正 
在 作为 用 于 所 有 种 类 的 嵌入 式 设 备 的 操作 系统 而 逐渐 变 得 流行 。 这 一 点 儿 也 不 奇怪 ， 因 为 它 的 源 代码 是 可 以 自由 获得 的 ， 而 县 包含 了 带 有 配置 工具 的 构 
建 系统 ， 该 构建 系统 使 得 开发 者 可 以 改变 系统 以 适应 不 同 的 硬件 设备 。 


特别 是 ， 如 果 目 标 设备 使 用 的 是 基于 ARM 的 片上 系统 并 且 有 触摸 屏 ， 那 么 Android 是 系统 工程 师 们 的 热门 选择 ， 因 为 对 硬件 的 必要 支持 是 系统 的 核 
心 部 分 。 对 瑞 特 尔 x86 架 构 的 移植 确实 存在 ， 但 是 可 用 的 硬件 更 少 ， 并 且 开 友 经 常 是 更 加 昂贵 的 。 


然而 ，Android 并 不 能 满足 肉 入 式 设 备 的 所 有 需求 。 虽 然 它 利用 了 在 Linux 操 作 系 统 栈 中 通常 见 到 的 Linux 内 核 和 其 他 软件 包 ， 但 是 它 的 基础 架构 不 
同 于 典型 的 Linux 操 作 系 统 栈 。Android 使 用 了 它 自己 的 由 一 套 精 简 过 的 应 用 程序 编程 接口 组 成 的 C 库 ， 其 中 也 有 自己 的 文件 系统 布局 以 及 其 他 特定 的 扩 
展 。 这 些 修 改 使 它 并 不 能 直接 移植 标准 Linux 软 件 包 到 Android。 


虽然 Android 在 这 个 意义 上 (整个 系统 的 源 代码 都 是 可 以 自由 获得 的 ， 在 很 少 限制 下 可 以 因为 任何 目的 而 被 使 用 、 修 改 和 扩展 ) 来 说 是 开源 项 目 ， 
但 是 开发 者 不 能 把 他 们 的 变更 贡献 回 Android。 人 谷歌 独 立 控制 着 这 个 系统 的 路 线 图 。 基 于 谷歌 的 Android 发 布 版 的 
CyanogenMod (www.cyanogenmod.org) 社区 发 行 版 正在 尝试 填补 这 一 空白 。 


尽管 如 此 ，Linux 内 核 确实 缺少 Android 的 一 个 重要 扩展 : 电源 管理 。 虽 然 一 些 Linux 内 核 开 发 人 员 因 其 过 于 简单 的 染 构 而 锐 眉 ， 但 Android 唤 醒 希 已 
经 成 为 Linux 电 源 管理 的 事实 标准 。 
Angstrim 发 行 版 


Angstrim 发 行 版 (主页 是 www.angstrom-distribution.org) 因 其 不 断 增 加 的 支持 开发 板 (development board) 的 列表 ， 正 在 逐渐 成 为 项 目的 重 
要 资源 。Angstrim 是 由 一 组 工作 在 OpenEmbedded、OpenZaurus 和 OpenSimpad 项 目 上 的 开发 者 启动 的 社区 发 行 版 。Angstrim 在 一 开始 就 使 用 了 
OpenEmbedded 工 具 ， 但 是 如 今 正 在 适应 Yocto 项 目的 架构 和 结构 。 


OpenWrt 


OpenWrt (www.openwrt.org) 首次 亮相 是 作为 针对 路 由 网 络 流量 的 获 入 式 设 备 的 开源 操作 系统 ， 例 如 宽 市 调制 解 调 器 、 路 由 器 、 住 宅 网 天 和 其 
他 客户 端 设备 (Consumer Premises Equipment, CPE) 。OpenWrt 的 核心 组 件 是 Linux 内 核 、uClibc 和 BusyBox。 


OpenWrt 的 早期 版 本 是 构建 在 用 于 Linksys 的 WRT54G 住 宪 网 天 和 无 线路 由 器 的 GPL 许 可 的 资源 以 及 用 Buildroot 所 创建 的 根 文 件 系 统 上 一 一 因此 有 
了 OpenWrt 这 个 名 字 。 


OpenWrt 支 持 多 种 硬件 设备 和 评估 板 。OpenWrt 的 核心 强项 是 全 面 的 配置 网 络 技 术 和 协议 的 能 力 列表 ， 包 括 路 由 、 网 状 网 络 、 防 火 墙 、 地 址 转换 、 
端口 转 友 、 负 和 载 均衡 以 及 更 多 的 功能 。 


虽然 OpenWrt 的 初衷 是 操作 那些 通常 运行 起 来 不 需要 频繁 人 工交 互 的 硬件 ,但 是 它 提供 了 高 级 网 页 界面 来 方便 地 访问 众多 的 配置 选项 。 


对 连接 能 力 和 远程 管理 的 天 注 使 得 OpenWrt 成 为 那些 开发 联网 设备 的 系统 工程 师 嘉 欢 的 选择 。 市 有 包 管 理 的 可 写 的 文件 系统 使 得 它 可 以 简单 地 增加 
功能 性 ， 即 使 企 系统 部 署 后 也 可 以 。 


完整 Linux 友 行 版 的 诅 入 式 版 本 


对 许多 成 熟 的 果 面 、 服 务 器 和 云 的 Linux 发 行 版 ， 针 对 藤 入 式 系 统 的 变 体现 在 也 可 以 使 用 了 : 


- Debian (www.emdebian.org) 

- Fedora (https: //fedoraproject.org/wiki/Embedded) 

- Gentoo (https://wiki.gentoo.org/wiki/Project: Embedded) 
- SUSE (https://tr.opensuse.org/MictoSUSE) 

- Ubuntu (https: //wiki.ubuntu.com/EmbeddedUbuntu ) 


对 熟悉 特定 Linux 友 行 版 的 桌面 或 者 服务 器 版 的 系统 构建 者 和 开 必 者 来 说 ， 使 用 它 的 嵌入 式 变 体 提供 了 由 熟悉 的 工具 、 文 件 系统 布局 以 及 其 他 所 市 来 
的 好 处 。 


1.2.2 ERNI Linux F RLA 
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况 下 ， 这 需要 更 多 的 努力 。 
Baserock 
Baserock 是 开源 项 目 ， 它 在 一 个 包 中 提供 了 面向 Linux 发 行 版 的 构建 系统 、 开 发 环境 和 开发 工作 流 。Baserock 的 主要 特点 是 : 
. 作为 提供 可 追踪 性 的 手段 ，Git 作 为 核心 来 管理 从 构建 指令 到 构建 制品 (artifact) 的 一 切 事物 。 
` 内 置 编译 以 避免 跨 构建 环境 的 复杂 度 。 
" 跨 多 个 系统 的 分 布 式 构 建 使 用 虚拟 机 。 


当前 ，Baserock 提 供 针对 x86、x86 64 和 ARMv7 架 构 的 构建 支持 。 该 项 目的 主页 是 http://wiki.baserock.org。 
Buildroot 


Buildroot 是 为 完整 的 谋 入 式 Linux 系 统 所 准备 的 构建 系统 。 它 使 用 GNU Make 和 一 套 makefile 来 创建 交叉 编译 的 工具 链 ， 有 根 文件 系统 、 内 核 镜像 
和 引导 加 载 程序 镜像 。 该 项 目的 主页 是 http://buildroot.uclibc.org。 


Buildroot 主 要 针对 小 型 认 入 了 式 系统 ， 并 且 文 持 多 种 CPU 架构 。 为 了 局 动 开 友 ， 它 限制 了 配置 选项 的 选择 ， 并 且 默 认 了 对 艇 入 式 系统 来 说 最 常用 的 选 
项 : 


.uClibc 是 用 以 构建 交叉 编译 工具 链 的 目标 库 。 和 GNU CÈ (glibc) 相 比 ，uClipbc 更 加 紧凑 ， 并 且 针 对 小 型 花 入 式 系 统 做 了 优化 。uClibc 支 持 几 乎 所 有 
CPU 架构 和 共享 的 库 以 及 线程 化 。 


` BusyBox 是 默认 的 命令 行 实用 程序 的 集合 。 


这 些 默认 的 设 定 通常 可 帮助 我 们 在 15 到 30 分 钟 内 用 Buildroot 来 构建 基本 的 误 入 式 Linux 系 统 ， 构 建 时 间 取 决 于 构建 的 主机 。 然 而 ， 这 些 设 定 不 是 绝 
对 的 ，Buildroot 的 简单 且 灵 活 的 结构 使 其 容易 理解 和 扩展 。 内 部 的 交叉 工具 链 可 以 用 外 部 的 工具 链 替 换 ， 例 如 crosstool-ng，UClibc 可 以 用 其 他 C 库 蔡 
换 。 


Buildroot 已 经 支持 很 多 标准 的 Linux 包 ， 例 如 X.org、GSstreamer、DirectFB 和 Simple DirectMedia Layer (SDL) 。 交 叉 工 具 链 可 以 用 来 构建 额外 
的 包 并 把 这 些 包 包含 在 根 文 件 系 统 中 。 


Buildroot 很 紧凑 并 且 容 易 设置 。 在 构建 主机 上 ， 单 一 文件 (压缩 包 ) 的 下 载 和 一 些 额外 包 的 安装 就 是 开始 所 需要 的 全 部 。 在 解压 了 压缩 包 
ja, make menuconfig 命 令 启 动 基 于 文本 的 用 户 界面 使 得 能 够 配置 大 量 被 支持 的 目标 和 设 定 其 他 选项 。 除 了 menuconfig 之 外 ，Buildroot 还 提供 了 
gconfig 和 xconfig， 它 们 是 可 选 的 图 形 用 户 界面 。 


通过 直接 从 上 游 项 目下 载 源 代码 文件 ，Buildroot 可 以 从 源 代码 创建 所 有 东西 。 一 个 不 错 的 功能 是 ， 离 线 的 构建 可 以 通过 使 用 make Source 下载 所 有 
源 代码 来 完成 。Buildroot 预 先 获 取 所 有 必需 文件 ， 然 后 在 不 需要 骨 连 接 到 互联 网 的 情况 下 配置 和 运行 构建 。 


OpenEmbedded 


OpenEmbedded (www.openembedded.org) 是 构建 框架 ， 它 包含 工具 、 配 置 数据 和 菜谱 以 创建 针对 嵌入 式 设备 的 Linux 发 行 版 。 处 在 
OpenEmbedded 核 心 的 是 管理 构建 过 程 的 BitBake 任 务 执行 器 


从 历史 上 来 说 ，OpenEmbedded 是 通过 合并 OpenZaurus 项 目 和 来 自 其 他 项 目 (例如 Familiar Linux 和 OpenSIMpad) 的 贡献 而 创建 出 来 的 。 


OpenEmbedded 曾 经 被 用 来 开 友 大量 的 开源 座 入 式 项 目 ， 最 知名 的 是 致力 于 为 手机 交付 完整 开源 软件 材 的 OpenMoko 项 目 
(http://wiki.openmoko.org) 。 


OpenEmbedded、Yocto 项 目 和 Angstrim 发 行 版 都 有 相同 的 根基 ， 它 们 以 各 种 形式 构建 在 对 方 之 上 并 且 互 相 补 充 。 在 下 一 章 深入 Yocto 项 目 细节 
时 ， 我 们 将 解释 共同 点 和 差异 。 


YoctoIn 


Yocto 项 目 当 然 是 本 书 的 主题 。 它 被 列 在 此 处 以 完整 家 入 式 Linux 形 势 的 概 吃 。 你 可 以 在 https://www.yoctoproject.org 找 到 它 的 网 页 。 


Yocto 项 目 不 是 单一 的 开源 项 目 而 是 代表 了 在 其 保护 伞 下 开 上 友和 维护 的 完整 项 目 家 族 。 本 书 会 摘 述 与 Yocto 项 目 相关 的 很 多 项 目 ， 特 别 是 
Poky，Yocto 项 目的 参考 发 行 版 ，Poky 包 括 了 OpenEmbedded 构 建 系统 和 一 整套 元 数据。 


嵌入 式 Linux 的 形势 是 多 样 的 。 这 个 列表 并 不 人 全面， 还 有 很 多 其 他 的 开源 项 目 提供 了 使 用 Linux 开 发 诸 入 式 设 备 的 解决 方案 。 在 我 看 来 ， 这 里 所 提 到 
的 项 目 是 最 活跃 和 最 经 常 使 用 到 的 。 在 继续 阅读 之 前 ， 你 可 能 希望 花 一 些 时 间 来 访问 这 些 项 目的 网 页 。 它 们 会 帮 你 理解 这 些 项 目的 目标 和 它们 之 间 的 比 
较 。 


也 有 一 些 商业 的 产品 补充 伐 入 式 Linux 形 势 。 常 见 的 情况 是 ， 这 些 产 品 包括 交叉 开发 工具 链 (cross-development toolchain) 、 发 行 版 构建 器 、 应 
用 开发 集成 开发 环境 以 及 更 多 。 越 来 越 多 的 嵌入 式 系 统 的 操作 系统 厂商 在 使 用 Yocto 项 目 作 为 上 游 。 它 们 使 用 Yocto 项 目 工 具 来 创建 产品 线 。 它 们 中 有 很 
多 是 Yocto 项 目的 成 员 ， 并 且 通 过 工程 化 和 人 金融 资源 来 支持 Yocto 项 目 。 


1.3 定制 Linux 发 行 上 








[==] 
AA 











务 。 需 要 考虑 操作 系统 的 很 多 不 同方 面 以 创建 完全 功能 性 的 计算 机 系统 。 





. 引导 加 载 程序 (Bootloader) : 引导 加 载 程序 是 第 一 个 软件 ， 它 负责 初始 化 硬件 、 加 载 操作 系统 内 核 到 内 存 中 然后 启动 内 核 。 引 导 加 载 程序 通常 
多 级 的 ， 其 第 一 级 存储 在 非 易 失 性 内 存 中 。 第 一 级 然后 从 挂 载 的 存储 (WAR BA) 中 加 载 第 二 级 。 以 此 类 推 。 


‘AK: 内 核 ， 如 其 名 所 示 ， 是 操作 系统 的 核心 。 它 管理 系统 的 硬件 资源 ， 并 且 通 过 它 的 应 用 程序 编程 接口 向 其 他 软件 提供 硬件 的 抽象 。 内 核 的 主 
要 功能 是 内 存 管理 、 设 备 管 理 和 响应 来 自 应 用 软件 的 系统 调用 。 这 些 功能 如 何 实现 依赖 于 处 理 器 梁 构 和 外 围 设 备 以 及 其 他 硬件 配置 。 


. 设备 驱动 : 设备 驱动 是 内 核 的 一 部 分 。 它 们 通过 内 核 系 统 调用 以 结构 化 的 形式 向 应 用 软件 提供 对 硬件 设备 的 访问 。 通 过 设备 驱动 ， 应 用 软件 可 以 
配置 硬件 、 从 硬件 读 取 数据 或 者 向 硬件 写 入 数据 。 


- 生命 周期 管理 (Life Cycle Management) : 从 通电 到 关机 ， 计 算 机 系统 呈现 多 个 状态 ， 在 这 些 状态 中 ， 它 向 应 用 软件 提供 不 同 集合 的 服务 。 生 
命 周期 管理 决定 什么 服务 运行 在 什么 状态 以 及 它们 需要 以 什么 顺序 启动 从 而 维持 一 致 性 的 操作 环境 。 生 命 周 期 管理 的 一 个 重要 内 容 也 是 电源 管理 ， 当 不 
需要 全 部 功能 时 把 系统 设置 成 节能 模式 ， 而 当 被 请 求 时 又 能 恢复 完全 操作 模式 。 


. 应 用 软件 管理 : 应 用 软件 和 库 组 成 了 在 典型 系统 上 安装 的 软件 的 大 部 分 ， 为 最 终 用 户 提供 功能 。 对 一 个 完整 的 可 操作 系统 来 说 ， 它 通常 需要 数 百 
到 数 千 个 软件 包 。 


Linux 和 大 量 的 开源 软件 包 都 如 同 构造 工具 包 的 组 成 部 分 。 不 笠 的 是 ， 它 更 像 一 个 迹 而 不 是 乐高 。 损 清楚 不 同 包 之 间 的 依赖 、 不 兼容 性 和 冲突 是 一 个 
艰巨 的 任务 。 一 些 包 甚至 提供 相同 或 者 相似 的 功能 。 选 择 哪 一 个 ”最 终 ， 你 将 必须 绘制 目 己 的 蓝图 从 而 为 能 入 陈 项 目 构建 Linux 友 行 版 。 原 则 上 ， 你 有 两 
种 方法 。 


BREF: 关于 这 种 方法 ， 你 一 开始 在 众多 可 用 的 Linux 发 行 版 中 选择 一 个 ， 并 根据 需求 ， 通 过 增加 或 移 除 软件 包 来 定制 它 。 多 年 前 本 书 作者 选择 
了 这 种 方法 (通过 运行 在 x86 服 务 器 硬件 上 的 高 速 图 像 处 理 系统 ) 。 这 是 一 种 可 行 的 方法 ， 并 具有 吸引 力 ， 因 为 使 用 经 过 测试 和 维护 的 发 行 版 减轻 了 一 些 


更 繁琐 的 构建 和 维护 自己 发 行 版 的 任务 。 而 且 你 可 能 会 为 此 获得 支持 。 然 而 ， 它 可 能 会 限制 你 对 硬件 的 选择 ， 因 为 大 部 分 现成 的 Linux 发 行 版 是 为 x86 硬 件 
所 构建 的 。 而 有 全， 选择 正确 的 发 行 版 来 开始 以 及 为 了 目标 设备 而 裁剪 它 也 不 是 简单 的 事情 。 


. 自 底 向 上 : 自 底 向 上 的 方法 需要 从 源 代码 构建 你 自己 定制 的 Linux 发 行 版 ， 先 从 引导 加 载 程序 和 内 核 开 始 ， 然 后 为 目标 设备 增加 软件 包 来 支持 应 用 
程序 。 这 种 方法 可 以 给 你 最 大 的 控制 权 (一 般 来 说 你 可 以 学 习 到 很 多 关于 Linux 和 操作 系统 的 内 容 ) ， 但 是 它 也 是 具有 挑战 性 的 任务 。 你 将 不 得 不 在 一 路 
上 做 出 许多 选择 ， 从 选择 合适 的 工具 链 到 设置 内 核 配置 选项 ， 再 到 选择 合适 的 软件 包 。 其 中 一 些 选择 是 互相 依赖 的 ， 例 如 工具 链 和 目标 库 的 选择 ， 并 且 
错误 的 选择 会 使 你 很 快 进入 死胡同 。 在 成 功 地 构建 和 部 署 了 发 行 版 以 后 ， 你 将 面临 维护 它 的 重担 -为 内 核 和 发 行 版 中 已 经 集成 的 所 有 其 他 软件 包 寻 找 
补丁 和 安全 更 新 。 





这 融 是 Yocto 项 目的 优势 所 在 。 通 过 提供 给 你 完整 的 工具 集 和 监 图 来 帮助 你 从 零 开 始 创建 你 自己 的 Linux 皮 行 版 〈 以 从 上 游 项 目 来 的 源 代码 下 载 开 
始 ) ， 它 集合 了 两 种 方法 的 优点 。 随 Yocto 项 目 工具 而 市 的 、 针 对 各 种 系统 的 蓝图 使 你 可 以 在 几 个 小 时 内 构建 完整 的 操作 系统 栈 。 你 可 以 从 下 面 这 些 监 图 
中 选择 : 针对 审 有 命令 行 登录 的 基本 系统 而 构建 目标 系统 镜像 的 监 图 、 针 对 移动 设备 而 构建 市 有 图 像 界面 的 系统 的 监 图 、 构 建 Linux 标 准 基础 兼容 的 系统 
的 蓝图 以 及 更 多 监 图 。 


你 可 以 使 用 这 些 蓝图 作为 你 自己 的 友 行 版 的 起 点 并 且 通 过 增加 或 删除 软件 包 来 修改 它们 。 本 书 的 剩余 章节 将 市 你 走 完 使 用 Yocto 项 目 工具 来 构建 和 有 定 
制 Linux 友 行 版 以 及 创建 你 目 己 的 监 图 的 整个 流程 ， 每 次 在 你 构建 系统 的 时 候 ， 这 都 会 给 你 可 重复 的 结果 。 


1.4 天 于 开源 许可 的 几 句 话 


当 构 建 基于 或 者 包含 开源 软件 的 系统 时 ， 你 将 不 可 避免 地 必须 注意 开源 许可 。 软 件 的 创始 作者 当然 可 以 目 由 选择 针对 他 们 的 成 果 所 倾向 的 任何 许 
可 ， 这 已 经 造成 了 很 长 并 且 仍 在 增长 的 开源 许可 列表 。 没 有 单一 的 许可 ， 并 且 不 管 你 喜欢 还 是 不 喜欢 ， 你 将 不 得 不 处 理 很 多 的 许可 。 一 些 开 源 项 目 甚 至 
会 使 用 不 止 一 个 软件 许可 。 这 样 的 例子 如 BusyBox。 


即使 不 是 最 常见 的 开源 许可 ， 也 是 最 常见 的 开源 许可 之 一 ， 就 是 GNU 通 用 公共 许可 (General Public License, GPL) [。GPL 现 在 是 第 3 版 了 ， 它 
被 广泛 地 认为 是 开源 许可 之 母 。 虽 然 一 些 来 源 把 创立 于 1990 年 的 BSD 许 可 作为 第 一 个 开源 许可 ， 但 是 通用 公共 许可 却 早 于 其 一 年 (由 Richard Stallman 
只 写 并 于 1989 年 发 布 ) 。 


一 个 归 因 于 开源 许可 的 流行 的 错误 认识 是 ， 开 源 软件 是 免费 的 。 然 而 ，GNU 通 用 公共 许可 的 第 2 段 对 这 种 常见 的 错误 理解 做 了 澄清 : “ 当 我 们 
it ‘free software’ 的 时 候 ， 我 们 说 的 是 目 由 (freedom) ， 而 不 是 价格 。 ”职业 的 工程 经 理 可 能 会 完全 同意 一 虽然 你 可 以 免费 下 载 开源 软件 ， 但 是 
开 友 和 部 署 基于 它 的 产品 通 音 要 伦 费 巨大 的 工程 成 本 。 从 这 个 意义 上 来 说 ， 开 源 软 件 和 商业 软件 产品 没有 什么 区 别 。 


相对 于 商业 或 者 闭 源 软件 许可 ， 开 源 许可 是 宽容 的 ， 这 意味 着 它们 给 予 你 使 用 和 运行 软件 的 自由 、 学 习 和 修改 它 的 权力 以 及 分 友 原 始 代 码 和 修改 版 
的 许可 。 这 种 广泛 的 自由 使 得 人 们 很 容易 漫不经心 地 对 待 开源 许可 。 一 句 话 : 不 要 这 样 做 。 开 源 许可 是 具有 约束 力 和 强制 执行 力 的 ， 正 如 任何 商业 许可 
一 样 。 


大 部 分 开源 许可 明确 约定 你 在 交付 基于 开源 代码 的 产品 时 需要 遵守 一 些 主要 条 件 : 
-JJA (Attribution) : 作者 们 必须 被 归 因 成 作品 的 创作 者 。 你 不 能 去 除 源 代码 的 任何 作者 的 任何 著作 权 声 明 。 


传输 (Conveyance) : 传输 通常 是 指 传送 源 代码 的 逐 字 副本 、 传 送 源 代码 的 修改 版 本 以 及 传送 非 源 代码 形式 (例如 二 进 制 文件 或 者 葵 入 在 产品 中 
的 固件 ) 。 在 后 一 种 情况 下 ， 很 多 开源 许可 ， 包 括 GNU 通 用 公共 许可 ， 要 求 你 传送 产品 对 应 的 源 代码 或 者 辅助 的 文档 。 


- 派生 作品 (Derivative Works) : 这 个 通常 指 的 是 包含 了 先前 创造 的 作品 的 全 部 或 者 主要 部 分 的 创作 物 。 对 于 开源 软件 来 说 ， 这 确切 地 意味 着 什 
么 仍然 不 明确 ， 因 为 目前 还 没有 针对 它 的 合法 的 测试 用 例 。 大 部 分 情况 下 ， 这 意味 着 修改 源 代 码 或 在 其 上 增加 内 容 ， 但 是 ， 对 一 些许 可 来 说 ， 也 包括 连 
接 黄 至 在 运行 时 动态 地 连接 到 库 。 在 许可 的 条 款 下 ， 派 生 作 品 的 作者 被 要 求 以 和 原始 作品 完全 相同 的 许可 条 款 分 发 作品 。 这 使 得 许可 可 以 自我 延续 (self- 


perpetuating) 。 


本 书 不 是 以 提供 有 关 开 源 许可 的 合法 建议 为 目的 而 写成 的 。 然 而 ,我 们 强烈 建议 你 在 实际 交付 产品 前 认真 对 待 包含 在 你 产品 中 的 软件 包 所 用 到 的 许 
可 。 昌 然 开源 许可 的 法 律 领域 还 相当 新 ， 但 是 越 来 越 多 的 法 律 专家 正在 专攻 这 个 领域 。 如 果 心 存疑 虑 ， 请 向 专家 们 寻求 专业 建议 。 


1] 关于 GPL 许 可 的 完整 文本 ， 请 参考 附录 人 A 或 者 查看 www.enu.org/licenses/egpl.html。 


1.5 ”组 织 、 相 天 实体 和 标准 


随 着 Linux 和 开源 在 计算 、 通 信 、 消 费 电 子 、 工 业 目 动 化 以 及 众多 其 他 领域 的 市 场 份额 在 继续 增加 ， 组 织 和 标准 正在 逐渐 形成 ， 这 影响 着 Linux 和 开 
源 技术 本 身 的 接受 度 和 米 用 度 以 及 它们 所 代表 的 开放 协作 和 创新 的 原则 。 本 市 将 介绍 一 些 你 可 能 希望 熟悉 的 组 织 、 实 体 和 标准 。 


1.5.1 ”Linux 基 人 金 会 
Linux 基 金 会 (Linux Foundation, www.linuxfoundation.org) 是 “ 非 营 利 性 的 致力 于 推动 Linux 发 展 的 共同 体 。 创 立 于 2000 年 ，Linux 基 金 会 筠 
助 Linux 创 造 者 Linus Torvalds 的 工作 并 且 被 来 自 全 世界 的 领先 的 技术 公司 和 开发 者 所 支持 。"” 
Linux 基 金 会 通过 以 下 方式 控制 它 的 成 员 以 及 开源 社区 的 资源 和 贡献 : 
- 促进 Linux 并 提供 针对 协作 和 教育 的 中 立 环 境 
` 保护 和 支持 Linux 开 发 
- 改进 Linux 作 为 技术 平台 


Linux 基 金 会 直接 赞助 Linus Torvalds 和 其 他 核心 Linux 开 发 者 的 工作 以 使 得 他 们 可 以 保持 独立 并 且 重 点 关注 于 改进 Linux。Linux 基 金 会 也 赞助 了 一 些 
工作 组 和 协作 项 目 以 定义 标准 和 推动 Linux 在 特定 领域 与 行业 的 友 展 。 其 中 一 些 项 目 在 稍 后 的 部 分 会 有 简要 描述 。 


1.5.2 Apache 软件 基金 会 
超过 140 个 开源 软件 项 目 是 由 Apache 软 件 基 金 会 (Apache Software Foundation, ASF) 所 拥有 的 。 对 于 这 些 项 目 ，Apache 软 件 基金 会 提供 了 包 
含 经 济 支持 、 知 识 产 权 管 理 和 法 律 支持 在 内 的 协作 框架 。Apache 软 件 基 金 会 的 网 站 可 以 在 www.apache.org 找 到 。 


你 可 能 已 经 熟悉 了 一 些 最 知名 的 Apache 软 件 基 金 会 的 项 目 ， 例 如 Apache HTTP 服 务 器 、 针 对 Java 的 Ant 构 建 工 具 、Cassandra 云 数据 库 、 
CloudStack 云 计算 基础 设施 、Hadoop 分 布 式 计算 平台 、 针 对 Java Servlet 和 JavaServer 网 页 的 Tomcat 网 站 服务 器 。 


所 有 的 Apache 项 目 和 在 Apache 软 件 基金 会 庇护 下 产生 的 软件 都 遵从 Apache 许 可 的 条 款 。Apache 许 可 的 重要 属性 是 ， 贡 献 者 保留 在 Apache 项 目 
外 部 因为 任何 目的 而 使 用 他 们 的 原始 贡献 的 全 部 权利 ， 同 时 给 予 Apache 软 件 基金 会 和 项 目 分 发 以 及 在 其 工作 之 上 构建 的 权利 。 


1.5.3 ”Eclipse 基金 会 


Eclipse 项 目 (www.eclipse.org) 是 2001 年 由 IBM 创 建 的 ， 目 的 是 围绕 Eclipse 平台 为 开 上 友 者 和 软件 厂商 构建 支持 的 社区 。Eclipse 平 台 是 作为 灵活 的 
针对 软件 开发 工具 的 集成 开发 环境 框架 而 开始 的 。 在 2004 年 ，Eclipse 基 金 会 作为 控制 该 项 目 资源 的 法 律 实体 而 建立 。Eclipse 基 金 会 为 在 其 庇护 下 运营 的 
项 目 提 供 信息 技 术 基 础 设施 和 知识 产权 管理 ， 以 及 支持 它们 的 开发 和 工程 过 程 来 保证 项 目的 透明 度 与 产品 质量 。 


除了 Eclipse 集 成 开发 环境 之 外 ， 在 Eclipse 基 金 会 保护 下 支持 的 项 目 列表 包括 针对 几乎 任何 编程 语言 的 开发 工具 、 软 件 和 数据 建 模 工 具 、 网 站 开发 工 
具 以 及 更 多 。 


藤 入 式 软 件 开发 框 染 频繁 地 构建 在 Eclipse 集 成 开 友 环境 上 ， 以 期 在 同一 个 集成 开 友 环境 内 提供 方便 的 包括 目标 调试 和 分 析 的 往返 开 友 。Yocto 项 目 
提供 了 可 直接 从 集成 开发 环境 内 启用 Yocto 项 目 创建 的 工具 链 的 Eclipse 插件 。 


1.5.4 ”Linux 标 准 基 


正如 上 一 节 概 述 的 ， 有 很 多 方式 可 以 构建 Linux 操 作 系 统 栈 。 虽 然 灵 活性 是 好 的 ， 但 是 随 之 而 来 的 是 分 裂 的 负担 。Linux 标 准 基 (Linux Standard 


Base, LSB) 的 目标 是 为 Linux 发 行 版 确立 一 套 通 用 标准 。 通 用 标准 提供 给 应 用 开发 者 这 样 的 保证 一 一 他 们 在 Linux 发 行 版 上 开发 的 代码 将 可 以 不 加 额外 
修改 地 运行 在 其 他 Linux 发 行 版 上 。 


另外 ， 当 遇 到 特定 Linux 皮 行 版 的 连续 性 问题 时 ，Linux 标 准 基 给 了 开 妈 者 平和 的 心态 。 只 要 皮 行 版 的 未 来 版 本 和 特定 的 Linux 标 准 基 的 版 本 保持 兼 


容 ， 应 用 将 会 继续 运行 在 这 个 太行 版 的 未 来 版 本 上 。 


Linux 标 准 基 项 目 提供 了 一 整套 规格 说 明 、 文 档 和 工具 来 检测 发 行 版 和 特定 Linux 标 准 基 的 兼容 性 。 


虽然 应 用 程序 编程 接口 和 应 用 二 进 制 接口 兼容 性 可 能 并 不 需要 处 在 对 嵌入 式 系统 工 程 师 来 说 的 列表 的 项 部， 但 是 从 长 远 来 看 ， 让 你 自己 熟悉 这 些 概 
念 和 规格 说 明 可 能 有 助 于 庶 入 式 项 目的 进行 。 即 使 你 不 希望 第 三 方 开发 来 向 谈 入 式 平台 贡献 应 用 ， 但 类 侯 那些 Linux 标 准 基 的 兼容 性 考虑 无 疑 支 持 你 产品 
的 平台 战略 。 


Linux 标 准 基 是 Linux 基 金 会 工作 组 。 你 可 以 在 www.linuxfoundation.org/collaborate/workgroups/lsb 找 到 它 的 网 站 。 


1.5.5 ”消费 电子 产品 工作 组 


消费 电子 产品 工作 组 (Consumer Electronics Workgroup) 是 在 Linux 基 金 会 庇护 下 运营 的 工作 组 。 它 的 任务 是 推进 Linux 在 用 于 消费 电子 产品 的 
嵌入 式 系 统 中 的 应 用 以 及 促进 Linux 本 身 的 增强 。 消 费 电 子 产 品 工作 组 在 2003 年 作为 消费 电子 Linux 论 坛 而 开始 工作 ， 并 且 在 2010 年 为 了 更 好 地 和 Linux 
社区 一 致 而 与 Linux 基 金 会 合并 。 可 以 在 www.linuxfoundation.org/collaborate/workgroups/celf 找 到 消费 电子 产品 工作 组 的 网 站 。 


消费 电子 产品 工作 组 的 主要 活动 之 一 是 长 期 支持 计划 (Long-Term Support Initiative, LTSI) 。 长 期 文 持 计划 的 目标 是 创建 和 维护 稳定 的 、 由 相关 
补丁 支持 大 概 2 ~ 3 年 的 Linux 内 核 树 ， 而 2 ~ 3 年 是 例如 智能 手机 、 游 戏 控制 端 和 电视 机 等 消费 电子 产品 通常 的 生命 周期 。 长 期 支持 计划 的 细节 发 布 
在 http://ltsi.linuxfoundation.org 中 。 


1.6 总 结 


启 入 式 Linux 正 在 为 许多 你 日 常 使 用 的 设备 和 服务 提供 动力 。 通 党 不 被 注意 到 的 是 ， 它 通过 互联 网 路 由 器 引导 数据 流 ， 把 高 清 图 片 放 在 电视 机 屏幕 
上 ， 在 导 舰 设备 内 部 为 旅行 者 导航 ， 人 在 智能 仪表 中 测量 能 源 消耗 ， 在 路 边 传感器 中 收集 交通 信息 以 及 更 多 。Linux 和 开源 正在 为 从 互联 设备 到 网 络 基 础 设 
施 及 数据 处 理 中 心 的 物 联网 提供 动力 。 本 章 为 即将 到 来 的 材料 准备 了 条 件 ， 履 善 以 下 主题 : 


: 工程 师 视 角 的 嵌入 式 系 统 的 定义 以 及 把 嵌入 式 产品 从 设计 带 到 生产 中 所 关联 的 一 系列 责任 
- 致力 于 针对 嵌入 式 设 备 的 Linux 快 速 采用 的 技术 开发 

HARK Linux BE 

与 构建 和 维护 操作 系统 栈 相关 联 的 挑战 

` 针对 详 入 式 项 目的 开源 许可 的 重要 性 


. 与 嵌入 式 Linux 有 关 的 一 些 组织 和 标准 
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第 2 Yocto 项 目 


Yocto 是 国际 单位 制 (International System of Units) (简写 为 91, 来 自 法 语 Le Systeme International d’ Unites) 指定 的 测量 单元 的 最 小 部 分 。 
它 命名 了 Yocto 项 目 一 一 用 于 构建 针对 众 入 了 式 设备 的 定制 的 Linux 发 行 版 的 一 套 综 合 的 工具 套件 、 模 板 和 资源 。 记 这 个 名 字 是 轻 摘 淡 写 ， 也 确实 是 轻 摘 淡 
与 。 

在 本 章 中 ， 我 们 通过 设置 由 Yocto 项 目 在 Poky 参 考 发 行 版 中 提供 的 OpenEmbedded 构 建 系统 ， 以 及 构建 我 们 的 第 一 个 完全 依赖 于 Poky 默 认 提 供 的 
蓝图 上 的 Linux 操 作 系统 栈 来 直接 切入 主题 。 我 们 在 本 章 中 执行 的 任务 为 接 下 来 的 章节 布景 ， 在 接 下 来 的 章节 里 ， 我 们 分 析 Yocto 项 目的 各 个 方面 ， 从 
Poky 工 作 流 到 OpenEmbedded 构 建 系统 (包括 BitBake 构 建 引擎 ) ， 到 定制 操作 系统 栈 ， 再 到 板 支 持 包 (Board support package, BSP) 和 应 用 开发 
工具 包 ， 以 及 更 多 。 


我 们 以 Yocto 项 目 和 OpenEmbedded 的 关系 以 及 Yocto 项 目 术 语 结束 本 章 。 


2.1 局 动 第 一 个 Yocto 项 目 构 建 








目 己 动 手 一 一 或 者 从 做 中 学 习 一 一 无 疑 是 获得 新 技能 的 最 好 方式 。 因 此 ， 我 们 通过 构建 第 一 个 用 于 QEMU (Quick Emulator, 一 个 适用 于 不 同 
CPU 架 构 的 通用 的 开源 机 器 模拟 器 ) 的 Linux 操 作 系 统 栈 开始 。 


本 章 学 习 如 何 准备 计算 机 以 成 为 Yocto 项 目 开 友 主机 、 获 取 和 安 妆 构建 系统 、 设 置 和 配置 构建 环境 、 局 动 和 监控 构建 过 程 ， 以 及 最 后 通过 在 QEMU 
模拟 器 中 启动 新 构建 的 Linux 操 作 系 统 栈 来 验证 构建 结果 。 


接 下 来 的 部 分 简要 描述 了 对 Yocto 项 目 主 机 来 说 的 硬件 和 软件 先决 条 件 。 如 果 不 希 望 立即 设置 构建 主机 ，Yocto 项 目 提 供 构建 器 具 (build 
appliance) ， 它 是 在 虚拟 机 中 预先 配置 的 系统 ， 使 得 你 能 够 在 不 安 半 任何 软件 的 情况 下 尝试 Yocto 项 目 工具 。2.1.7 节 简要 摘 述 了 如 何 用 Yocto 项 目的 构 
建 器 具 来 进行 测试 。 


2.1.1 ”先决 条 件 
你 可 能 已 经 猜 到 了 : 为 了 用 Yocto 项 目 工具 构建 Linux 系 统 ， 需 要 一 个 运行 着 Linux 的 构建 主机 。 


硬件 条 件 


尽管 Yocto 项 目 工 具 具 备 构 建 Linux 操 作 系 统 栈 的 能 力 ， 但 是 其 需要 带 有 x86 架 构 CPU 的 构建 主机 。32 位 和 64 位 CPU 都 是 被 支持 的 。 出 于 吞吐 量 的 原 
因 ， 市 有 64 位 CPU 的 系统 是 首选 的 。Yocto 项 目的 构建 系统 在 可 能 的 情况 下 利用 并 行 处 理 (parallel processing) 。 因 此 ， 市 有 多 个 CPU 或 者 一 个 多 核 
CPU 的 构建 主机 能 极 大 地 减少 构建 时 间 。 当 然 ，CPU 时 钟 速度 也 对 包 能 够 多 快 构建 出 来 有 影响 。 


内 存 也 是 重要 因素 。BitBake 一 一 Yocto 项 目的 构建 引擎 ， 解 析 数 干 个 “菜谱 ” (recipe) 并 且 创 建 囊 有 构建 依赖 项 的 缓存 。 而 且 ， 编 译 器 需要 内 存 
来 存储 数据 结构 和 更 多 其 他 数据 。Yocto 项 目 工 具 在 小 于 1GB 内 存 的 系统 上 不 能 运行 。 推 荐 的 是 4GB 或 者 更 多 内 存 。 


磁盘 空间 也 是 考虑 因素 。 当 前 ， 完 整 的 构建 过 程 一 一 创建 基于 X11 的 市 有 图 形 用 户 界 面 (Graphical User Interface, GUI) 的 镜像 一 一 消耗 大 约 
50GB 的 磁盘 空间 。 如 果 你 想 在 将 来 为 更 多 以 构 构 建 或 向 构建 增加 更 多 的 包 ， 那 么 需要 额外 的 空间 。 推 荐 的 是 ， 系 统 的 硬盘 有 人 至少 100CB 的 可 用 空间 。 


为 大 容量 的 普通 硬盘 的 价格 已 经 是 普遍 用 户 可 承受 的 了 ， 推 荐 你 用 带 有 500GB 或 者 更 多 空间 的 主机 来 承载 Yocto 项 目的 全 部 构建 环境 。 


因为 构建 系统 从 磁盘 读 取 大 量 数据 并 向 磁盘 写 入 大 量 构建 输 出 数据 ， 市 有 高 MO 吞吐 率 的 磁盘 也 可 以 极 大 地 加 速 构建 过 程 。 使 用 固态 盘 可 以 进一步 改 
善 构建 体验 ， 但 是 ， 这 些 设备 ， 特 别 是 具有 大 容量 的 ， 在 成 本 上 是 远 局 于 具有 旋转 盘 片 的 普通 磁盘 的 。 不 管 你 正在 使 用 传统 的 硬盘 还 是 固态 盘 ， 额 外 的 
性 能 增加 可 以 通过 设置 独立 磁盘 见 余 阵列 (Redundant Array of Independent Disks, RAID) 来 实现 ， 例 如 RAID 0。 


互联 网 连接 


可 从 Yocto 项 目 网 站 获取 的 OpenEmbedded 构 建 系统 仅仅 包含 构建 系统 本 身 一 一 BitBake 和 和 引导 它 的 元 数据 。 对 于 它 将 要 构建 的 软件 来 说 ， 它 不 包 
含 任何 源 包 。 这 些 源 包 是 在 构建 运行 时 按 需 自动 下 载 下 来 的 。 因 此 ， 你 需要 一 个 接 人 至 互联 网 的 在 线 连接 ， 最 好 是 高 速 连接 。 


当然 ， 下 载 的 源 包 是 存储 在 系统 上 并 且 对 于 将 来 的 构建 来 说 可 以 重用 。 你 也 可 以 提前 下 载 所 有 的 源 包 然后 在 没有 接 至 互联 网 的 连接 的 情况 下 离线 地 
构建 它们 
软件 需求 


首先 ， 你 需要 当前 的 Linux 发 行 版 。 随 着 每 次 版 本 发 布 ，Yocto 项 目 正在 持续 认可 越 来 越 多 的 发 行 版 。 使 用 以 下 发 行 版 之 一 的 前 一 个 或 者 当前 发 布 通 
单 没有 任何 问题 : 


- CentOS 

- Fedora 

* openSUSE 
- Ubuntu 


一 般 情况 下 ，32 位 和 64 位 变 体 都 是 验证 过 的 。 然 而 ， 如 果 硬 件 支 持 64 位 版 本 ， 那 么 束 推 荐 使 用 64 位 版 本 。 可 以 在 位 
于 www.yoctoproject.org/docs/current/ref-manual/ref-manual.html 的 Yocto 项 目 参 考 手册 中 找到 所 有 被 支持 的 发 行 版 的 详细 列表 。 


除了 Linux 上 故 行 版 ， 你 需要 安 和 一 系列 软件 包 以 使 构建 系统 运行 。 我 们 会 在 2.1.3 节 阐述 安 委 。 


2.1.2 ”获取 Yocto 项 目 工具 


对 你 来 说 ， 获 取 Yocto 项 目 工具 有 很 多 方式 ， 或 者 更 准确 地 说 ，Yocto 项 目 参考 太行 版 Poky: 
.从 Yocto 项 目 网 站 下 载 当 前 发 布 。 
: 从 发 布 仓库 下 载 当 前 发 布 或 者 先前 发 布 的 版 本 。 
.从 自动 构建 器 (Autobuilder) 仓库 下 载 一 个 当前 的 每 夜 构建 。 
- 从 由 Yocto 项 目 Git 仓 库 服务 器 承载 的 Poky Git 仓 库 中 克隆 当前 开发 分 支 或 者 其 他 分 支 。 


每 6 个 月 ， 在 每 年 4~ 5 月 和 10 ~ 11 月 时 间 段 内 ，Yocto 项 目 团队 发 布 构建 系统 的 新 的 主 版 本 (major version) 。 所 有 已 发 布 的 Yocto 项 目 工 具 都 经 
过 了 多 轮 的 质量 保证 和 测试 。 它 们 是 稳定 的 ， 并 且 还 附带 了 发 布 说 明和 更 新 过 的 描述 特性 的 文档 集 。 对 Yocto 项 目 新 手 来 说 ， 推 荐 使 用 当前 的 稳定 发 布 版 
本 。 

解决 了 问题 但 没有 增加 新 特性 的 次 版 本 (minor version) 于 6 个 月 发 布 周 期 中 间 的 必要 时 刻 提出 。 因 为 没有 新 特性 ， 所 以 文档 通常 不 会 随 着 次 版 本 
的 发 布 而 变化 。 

以 前 的 主 版 本 和 次 版 本 被 归档 并 且 可 以 从 下 载 仓 库 中 下 载 。 有 时 ， 新 的 主要 发 布 引 入 新 的 层 结 构 、 新 的 配置 文件 或 配置 文件 中 新 的 配置 项 。 因 此 ， 
迁移 现 有 的 构建 环境 到 更 新 的 发 布 版 本 可 能 需要 付出 努力 。 留 在 前 一 个 版 本 使 得 你 可 以 延迟 或 者 彻底 取消 迁移 。 

每 夜 构建 追踪 Yocto 项 目 Git 仓 库 中 代码 基 的 当前 开发 状态 。 这 些 构建 接受 了 基本 的 质量 保证 和 自动 构建 器 测试 。 它 们 的 测试 没有 像 正 常 的 主 发 布 和 
次 发 布 那 样 严 格 ， 但 是 你 至 少 可 以 获取 这 样 的 信心 一 一 核心 功能 是 可 运行 的 。 





从 Poky Git 仓 库 克 隆 当 前 的 开 友 分 文 (EFRON) 可 让 你 对 当前 状态 的 开 友 工作 直接 访问 。 对 这 个 分 广 的 修改 除了 开 友 人 员 人 在 他 们 提交 签字 前 做 过 
的 测试 以 外 ， 没 有 任何 其 他 测试 。 虽 然 质量 通 弟 是 高 的 ， 并 且 任 何 严重 的 核心 功能 破坏 通常 可 以 在 开 友 人 员 迁 进 变更 后 的 短 时 间 内 检测 出 来 ， 但 是 很 有 
可 能 ， 系 统 不 能 像 期 待 的 那样 工作 。 除 非 你 直接 参与 Yocto 项 目 开 发 ， 否 则 没有 必要 直接 工作 在 主干 分 支 上 。 


除了 主干 分 支 ， Poky 的 Git 仓 库 还 包含 了 里 程 碑 分 支 、 对 各 个 版 本 的 开发 分 支 和 长 的 标签 (索引 到 各 个 分 支 的 特定 修订 ) 列表 。 


在 接 下 来 的 章节 里 ， 我 们 简要 描述 如 何 从 各 个 地 方 下 载 Yocto 项 目的 友 布 。 我 们 也 会 细致 地 探索 针对 Poky 的 Yocto 项 目的 Git 仓 库 、 板 支持 包 、Linux 
内 核 以 及 更 多 内 容 。 


下 载 当前 的 Poky 发 布 版 本 


导航 到 https://www.yoctoproject.org/downloads， 然 后 在 Poky 的 最 新 发 布 版 本 处 单 击 。 这 个 链接 把 你 转 到 详细 的 、 存 在 指向 到 各 个 下 载 服 务 器 
和 镜像 的 链接 的 下 载 网 站 。 该 网 站 也 包含 发 布 信息 和 勘误 。 


下 载 发 布 版 本 会 把 名 字 为 poky-<codename>-<release>.tar.bz2 的 Poky 参 考 发 行 版 压缩 包 放 在 系统 上 。 


2.1.3 ”设置 构建 主机 

设置 构建 主机 需要 安 六 额外 的 软件 包 。 所 有 4 个 主流 的 Linux 友 行 版 的 包 仓 库 中 都 包含 这 些 直 接 可 用 的 包 。 然 而 ， 在 作为 该 友 行 版 的 默认 配置 下 哪些 
包 被 预先 安装 方面 ， 这 些 发 行 版 是 有 区 别 的 。 

安 六 完 额外 的 包 后 ， 需 要 解压 Poky 压 缩 包 一 一 它 包括 所 有 必要 的 配置 数据 、 菜 谱 、 便 利 性 脚本 和 BitBake。 

BitBake 需 要 2.6 或 者 2.7 主 版 本 的 Python。BitBake 当 前 不 支持 新 的 Python 3 (Python 3 引入 了 打破 向 后 兼容 的 语言 语法 和 新 的 库 ) 。 
安 委 额外 的 软件 包 

使 用 什么 命令 和 安 半 什么 额外 的 包 取 决 于 安 半 在 构 建 主机 上 的 Linux 友 行 版 。 

为 了 在 CentOS 构 建 主机 上 安装 必要 的 包 ， 使 用 程序 清单 2-1 的 命令 。 


程序 清单 2-1 CentOS 


user@centos:~$ sudo yum install gawk make wget tar bzip2 gzip \ 
python unzip perl patch diffutils diffstat git cpp gcc gcc-ct++ \ 
glibc-devel texinfo chrpath socat perl-Data-Dumper \ 
perl-Text-ParseWords perl-Thread-Queue SDL-devel xterm 


为 了 设置 Fedora 构 建 主 机 ， 执 行程 序 清单 2-2 中 的 命令 。 
程序 清单 2-2 Fedora 


user@fedora:~$ sudo dnf install gawk make wget tar bzip2 gzip python \ 
unzip perl patch diffutils diffstat git cpp gcc gcc-c++ glibc-devel \ 
texinfo chrpath ccache perl-Data-Dumper perl-Text-ParseWords \ 
perl-Thread-Queue socat findutils which SDL-devel xterm 


程序 清单 2-3 显 示 了 针对 openSUSE 构 建 主机 的 安装 命令 。 
程序 清单 2-3 openSUSE 


user@opensuse:~$ sudo zypper install python gcc gcc-c++ git chrpath \ 
make wget python-xml diffstat makeinfo python-curses patch socat \ 
libSDL-devel xterm 


在 Ubuntu 构建 主机 上 ， 执 行程 序 清单 2-4 的 命令 。 


程序 清单 2-4 Ubuntu 


user@ubuntu:~$ sudo apt-get install gawk wget git-core diffstat \ 
unzip texinfo gcc-multilib build-essential chrpath socat \ 
libsd11.2-dev xterm 


在 安 妆 成 功 以 后 ， 你 可 能 希望 验证 正确 版 本 的 Python 被 安装 了 : python--version。 输 出 应 该 显示 2.6 或 者 2.7 的 主 版 本 号 。 
安装 Poky 


安 半 Poky 时 仅仅 需要 解压 先前 从 Yocto 项 目 网 站 下 载 下 来 的 压缩 包 。 推 荐 你 在 家 目录 中 为 所 有 有 关 Yocto 项 目 构 建 的 东西 创建 子 目 录 。 程 序 清单 2-5 


显示 了 必要 的 步骤 。 
程序 清单 2-5 安装 Poky 
user@buildhost:~$ mkdir ~/yocto 


user@buildhost:~$ cd ~/yocto 
user@buildhost:~$ tar xvfj <downloadpath>/poky-<codename>-release.tar.bz2 


现在 构建 系统 已 经 准备 好 ， 可 以 设置 构建 环境 和 创建 第 一 个 Linux 操 作 系 统 栈 了 。 


2.14 配置 构建 环境 
Poky 提 供 了 脚本 oe-init-build-env 来 创建 新 的 构建 环境 。 这 个 脚本 设置 构建 环境 的 目录 结构 和 初始 化 核心 集合 的 配置 文件 。 它 也 设置 一 系列 构建 系 
统 所 需要 的 shell 变 量 。 你 不 直接 执行 oe-init-build-env 脚 本 而 是 使 用 source 命 令 来 把 shell 变 量 设置 输出 到 当前 的 shell: 
S source <pokypath>/oe-init-build-env <builddir> 
执行 这 个 命令 在 当前 目录 中 以 由 参数 <builddir> 提 供 的 名 字 创 建新 的 构建 环境 。 你 可 以 省 略 这 个 参数 ， 那 么 脚本 会 使 用 默认 的 build 作 为 名 字 。 在 设 
置 了 构建 环境 后 ， 脚 本 改变 目录 到 构建 目录 。 
使 用 程序 清单 2-6 所 示 形 式 的 脚本 来 创建 新 的 构建 环境 并 且 初 始 化 先前 创建 的 现 有 的 构建 环境 。 在 创建 新 的 构建 环境 时 ， 脚 本 提供 给 你 一 些 指示 。 


程序 清单 2-6 ”新 构建 环境 设置 


You had no conf/local.conf file. This configuration file has therefore been 
created for you with some default values. You may wish to edit it to use a 
different MACHINE (target hardware) or enable parallel build options to take 
advantage of multiple cores, for example. See the file for more information, as 
common configuration options are commented. 


The Yocto Project has extensive documentation about OE including a reference 
manual which can be found at: 
http://yoctoproject.org/documentation 


For more information about OpenEmbedded see their website: 
http://www. openembedded. org/ 


You had no conf/bblayers.conf file. The configuration file has been created 
for you with some default values. To add additional metadata layers into your 
configuration, please add entries to this file. 
The Yocto Project has extensive documentation about OE including a reference 
manual which can be found at: 

http://yoctoproject.org/documentation 


For more information about OpenEmbedded see their website: 
http://www. openembedded. org/ 


### Shell environment set up for builds. ### 
You can now run 'bitbake <target>' 


Common targets are: 
core-image-minimal 
core-image-sato 
meta-toolchain 
meta-toolchain-sdk 
adt-installer 
meta-ide-support 


You can also run generated qemu images with a command like 'rungemu gemux86' 


在 新 创建 的 构建 环境 里 面 ， 该 脚本 增加 了 目录 conf 并 且 把 两 个 配置 文件 放 在 里 面 : bblayers.conf 和 local.conf。 我 们 会 在 第 3 章 中 详细 解释 
bblayers.conf。 现 在 仅仅 看 看 local.conf， 它 是 构建 环境 的 主要 配置 文件 。 


在 local.conf 中 ， 设 置 各 个 变量 以 影响 BitBake 构 建 自 定义 的 Linux 操 作 系 统 栈 。 你 可 以 修改 设置 并 且 可 以 向 文件 中 加 入 新 的 设置 以 履 盖 在 其 他 配置 广 
件 中 做 出 的 设置 。 通 过 贯穿 本 书 的 各 个 例子 ， 我 们 会 解释 这 种 集成 以 及 如 何 使 用 它 。 对 于 我 们 的 第 一 个 构建 来 说 ， 我 们 聚焦 在 少量 设置 上 上， 剩余 的 设置 
采用 默认 值 。 如 果 在 文本 编辑 器 中 打开 local.conf 文 件 ， 那 么 你 将 发 现在 程序 清单 2-7 中 显示 的 设置 (在 众多 里 面 ， 它 包括 从 这 个 程序 清单 里 面 清除 的 注 
释 行 ) 。 


程序 清单 2-7 conf/local.conf 


BB_NUMBER_THREADS ?= "${@bb.utils.cpu_count () }" 
PARALLEL _ MAKE ?= "-j ${@bb.utils.cpu_count() }" 
MACHINE ??= "gemux86" 

DL_DIR ?= "${TOPDIR}/downloads" 

SSTATE_DIR ?= "S{TOPDIR}/sstate-cache" 

TMP_DIR = "S${TOPDIR}/tmp" 


以 井 字符 (#) 开头 的 行 是 注释 。 如 果 有 变量 设置 的 行 的 行 首 和 有 并 字 符 ， 那 么 需要 去 除 井 字符 以 使 得 设置 生效 。 显 示 的 值 是 默认 值 。BitBake 使 用 这 
些 值 ， 即 使 你 没有 明确 局 用 它们 。 在 程序 清单 2-7 中 显示 的 变量 配置 是 在 创建 了 新 的 构建 环境 以 后 通常 希望 改变 的 变量 配置 。 它 们 摘 述 在 表 2-1 中 。 


表 2-1 配置 变量 


BB NUMBER THREADS 并 发 的 BitBake 任务 的 数量 

PARALLEL MAKE 并 发 的 Make 进程 数量 

DL DIR 源 下 载 被 存放 的 目录 

SSTATE_DIR 共享 的 状态 缓存 文件 的 目录 
StTOPDIR)Mtmp 


TMP DIR $ {TOPDIR}/tmp 构建 输出 的 目录 


两 个 并 上 友 选 项 BB_ NUMBER_THREAD9s 和 PARALLEL_MAKE 的 默认 值 是 以 使 用 所 有 可 用 核心 的 系统 中 的 CPU 核心 数量 为 基础 自动 计算 出 来 的 。 你 6 
以 通过 将 这 些 值 设 置 得 比 你 系统 中 的 核心 数量 少 来 限制 负载 。 使 用 比 物 理 核 心 数 更 大 的 值 是 可 能 的 ， 但 是 不 加 速 构建 过 程 。BitBake 和 Make 对 应 地 派生 
更 多 线程 ， 但 是 它们 仪 仪 在 CPU 核 心 可 用 的 情况 下 运行 。 永 远 不 要 志 记 变量 设置 前 后 的 引号 。 也 要 注意 到 ， 对 于 PARALLEL MAKE， 应 该 包含 -j， 例 
如 “-j 4”， 因 为 这 个 值 会 被 一 字 不 差 地 传递 到 make 命 令 。 


设置 MACHINE 选 择 BitBake 构 建 Linux 操 作 系统 栈 所 针对 的 目标 机 器 类 型 。Poky 提 供 了 一 系列 针对 QEMU 和 一 些 实际 硬件 板 目 标 机 器 的 标准 机 器 。 
板 支 持 包 可 以 提供 额外 的 目标 机 器 。 对 于 我 们 的 第 一 个 构建 来 说 ， 选 择 qemux86 一 一 市 有 x86 CPU 的 模拟 的 目标 机 器 。 


变量 DL_DIR 告 诉 BitBake 把 源 下 载 放 在 什么 地 方 。 默 认 的 设置 把 文件 放 在 构建 环境 顶级 目录 下 的 downloads 目 录 中 。TOPDIR 变 量 包 合 到 构建 环境 
的 完整 (绝对 ) 路 径 。 源 下 载 可 以 在 多 个 构建 环境 之 间 共 享 。 如 果 BitBake 检 测 到 源 下 载 在 下 载 目录 中 已 经 是 可 用 的 了 ， 那 么 BitBake 不 会 再 次 下 载 它 。 
因此 ， 推 荐 你 设置 DL_DIR 变 量 来 指向 到 构建 环境 之 外 的 目录 路 径 。 当 不 再 需要 特定 的 构建 环境 时 ， 可 以 简单 地 删除 它 而 不 会 删除 所 有 的 源 文件 下 载 。 


对 于 SSTATE_DIR 也 是 这 样 的 ， 它 包含 到 共享 状态 缓存 的 路 径 。OpenEmbedded 在 处 理 构建 了 组 成 Linux 操 作 系统 栈 的 包 所 必需 的 很 多 任务 中 产生 
大 量 中 间 输 出 。 和 源 下 载 类 似 ， 中 间 输 出 对 将 来 的 构建 来 说 是 可 以 重用 的 并 且 在 多 个 构建 环境 之 间 共 享 以 加 速 构建 过 程 。 默 认 情 况 下 ， 配 置 把 共享 状态 
缓存 目录 放 在 构建 环境 顶级 目录 下 面 。 建 议 你 把 这 个 设置 改 成 构建 环境 之 外 的 路 径 。 


变量 TMP_DIR 包 仿 到 BitBake 执 行 所 有 构建 工作 和 存储 构建 输出 的 目录 的 路 径 。 因 为 在 这 个 目录 下 存储 的 输出 是 非常 特定 于 构建 环境 的 ， 所 以 保留 
写作 为 到 构建 环境 的 子 目 录 是 有 意义 的 。 在 该 目录 下 存储 的 数据 量 可 能 会 最 终 占用 很 多 GB 的 硬盘 空间 ， 因 为 它 包 含 解 压 出 来 的 源 下 载 、 交 又 编译 工具 
链 、 编 译 输 出 和 针对 目标 机 器 的 内 核 镜像 以 及 根 文件 系统 。 


为 了 在 构建 中 保留 磁盘 空间 ， 可 以 增加 


INHERIT += rm_work 


它 命 令 BitBake 人 在 构建 完 包 之后 删除 针对 构建 包 的 工作 目录 。 


2.1.5 ”启动 构建 
为 了 局 动 构建 ， 从 构建 环境 的 顶级 目录 调用 BitBake 指 定 构建 目标 : 
S bitbake <build-target> 


在 接 下 来 的 章节 里 ， 我 们 将 深入 到 什么 是 构建 目标 以 及 如 何 使 用 它们 来 控制 构建 输出 的 细节 。 对 于 我 们 的 第 一 个 构建 来 说 ， 我 们 使 用 创建 了 市 有 
形 用 尸 界面 的 完整 Linux 操 作 系统 栈 的 构建 目标 。 从 在 前 面部 分 创建 和 配置 过 的 构建 环境 的 顶级 目录 中 ， 执 行 以 下 命令 : 


S bitbake core-image-sato 


core-image-sato 目 标 创 建 针对 移动 设备 的 市 有 用 户 界 面 的 根 文 件 系 统 镜 像 。 依 赖 于 构建 硬件 和 用 于 下 载 源 文 件 的 互联 网 的 速度 ， 构 建 可 能 会 化 费 1 
到 数 个 小 时 不 等 的 时 间 。 


也 可 以 命令 BitBake 先 下 载 所 有 源 而 不 构建 ， 用 以 下 的 命令 实现 : 


S bitbake -c fetchall core-image-sato 


在 下 载 完 成 后 ， 可 以 断 开 构建 系统 与 互联 网 的 连接 ， 在 以 后 的 时 间 里 离线 运行 构建 。 


如 果 BitBake 遇 到 了 它 无 法 恢复 的 错误 ， 那 么 通常 会 立即 终止 构建 过 程 。 然 而 ， 你 可 以 命令 BitBake 继 续 构 建 ， 即 使 它 遇 到 了 错误 ， 只 要 剩余 的 任务 
并 不 被 这 个 错误 所 阻碍 束 行 : 


9 bitbake -k core-image-sato 


-k 选 项 告诉 BitBake 继 续 构建 直到 不 依赖 这 个 错误 的 任务 被 处 理 。 


2.1.6 ”验证 构建 结果 


因为 我 们 的 目标 机 器 是 模拟 的 系统 ， 所 以 可 以 通过 启动 QEMU 模 拟 器 来 验证 构建 结果 。 对 此 ，Poky 提 供 了 一 个 便利 的 脚本 ,该 脚本 准备 QEMU 执 行 
环境 并 用 合适 的 内 核 和 根 文 件 系 统 镜 像 来 局 动 模拟 器 : 


S rungemu gemux86 


在 最 简单 的 形式 下 ，rundqemu 脚 本 以 目标 机 器 名 字 作 为 参数 被 调 用 。 然 后 ， 它 在 构建 输出 中 目 动 为 目标 寻找 合适 的 内 核 和 根 文 件 系统 镜像 。 你 必须 
输入 系统 管理 员 (或 者 sudo) 密码 以 使 脚本 去 设置 虚拟 网 络 接口 。 图 2-1 显 示 了 运行 中 的 系统 。 


你 可 以 通过 单 击 Utilities 屏幕 中 的 Shutdown 按 钮 来 终止 QEMU 虚 拟 机。 其 按照 关机 顺序 来 恰当 地 关闭 系 统 。 或 者 是 ， 你 可 以 简单 地 在 你 局 动 QEMU 
Agim- A Ctrl-C, 


Appearance | | Bridges | Desktop Pref... 


Change the appe... Play Bridges. Change desktop ... 


_ Fifteen » File Manager ... inertia 


Play Fifteen. » Browse the file sy 7 Play Inertia. 


eS Music Player 
Play Map | Play your favourite... 


Preferred Ap... x Samegame 


Play Samegame. 


Slant Terminal 


+: 


Play Slant When all else fails. 





图 2-1 A core-image-sato A #7 49 QEMU 


2.1.7 Yocto 项 目 构 建 器 具 


如 果 你 仅仅 想 尝 试 Yocto 项 目 和 Poky 而 不 设置 Linux 构 建 主 机 ， 那 么 可 以 使 用 Yocto 项 目 构 建 器 具 。 构 建 器 具 是 完整 的 Yocto 项 目 构 建 主机 ， 包 括 珊 
有 OpenEmbedded 构 建 系统 和 Poky 需 要 的 已 安 半 的 软件 包 的 Linux 操 作 系统 ， 被 捆绑 为 虚拟 机 和 镜像。 它 甚至 包括 了 所 有 的 源 包 下 载 ， 能 加 速 第 一 个 构建 
和 使 你 能 够 在 没有 网 络 连接 的 情况 下 离线 地 构建 。 


构建 器 具 可 从 Yocto 项 目 网 站 https://www.yoctoproject.org/download/build-appliance-0 下 载 。 构 建 器 有 具 以 ZIP 压 缩 包 的 形式 提供 ， 需 要 在 下 载 
后 于 系统 上 把 解压 。 


为 了 使 用 构建 器 具 ， 需 要 使 用 在 计算 机 上 安装 的 VMWare Player 或 者 VMWare Workstation。 从 VMWare 网 站 www.vmware.com 的 下 载 部 分 ， 可 
以 获取 匹配 计算 机 上 的 操作 系统 的 VMWare Player 或 者 VMWare Workstation。 遵 循 由 VMWare 提 供 的 安 沪指 南 。 


一 旦 安装 了 VMWare Player 或 者 VMWare Workstation， 便 可 知 在 https://www.yoctoproject.org/documentation/build-appliance-manual 上 
的 构建 器 具 手 册 提 供 了 详细 的 、 关 于 如 何 配置 虚拟 机 和 启动 构建 器 具 的 指南 。 


如 图 2-2 所 示 ， 局 动 构 建 器 具 时 直接 局 动 了 针对 BitBake 的 Hob 图 形 用 户 界 面 。 
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图 2-2 ”Yocto 项 目 构建 器 有 具 


从 下 拉 框 中 针对 机 器 选择 qemux86、 针 对 基础 镜像 选择 core-image-sato， 然 后 开始 构建 。 取 决 于 主机 系统 和 虚拟 机 配置 ， 它 可 能 要 花费 数 个 小 时 
来 构建 镜像 。 你 可 以 从 Hob 的 Log 屏 幕 上 观察 构建 过 程 。Log 屏 幕 显 示 了 在 运行 队列 中 被 分 成 独立 任务 的 那些 要 构建 的 包 。 当 前 运行 的 任务 被 高 亮 显 示 。 


在 构建 完成 后 ， 你 可 以 直接 从 Hob 中 用 QEMU 模 拟 器 启动 镜像 。 


2.2 Yocto 项 目 系 人 多 


Yocto 项 目 不 仅 仅 是 单一 的 开源 项 目 而 是 在 一 个 名 字 下 集合 了 多 个 项 目 。 你 已 经 见 过 了 该 项 目 系列 中 的 最 重要 的 成 员 : OpenEmbedded 构 建 系统 ， 
它 包 括 BitBake、OpenEmbedded 核 心 和 Poky (Yocto 项 目 参 考 上 太行 版 ) 。 


基本 上 ， 所 有 系列 成 员 都 支持 OpenEmbedded 构 建 系统 。Yocto 项 目 团 队 和 OpenEmbedded 项 目 ( 另 一 个 组 织 ) 一 起 维护 构建 系统 。 随 着 构建 系 
统 进化 ， 新 功能 被 增加 到 子 项 目 中 。 


表 2-2 提 供 了 作为 Yocto 项 目 部 分 维护 的 子 项 目的 概览 。 


表 2-2 Yocto 项 目 系 列 


内 部 项 目 


应 用 开发 工具 ( Application 
Development Toolkit, ADT) 


AutoBuilder 


BitBake 


构建 希 具 


交叉 预先 链接 (cross-prelink ) 


Eclipse 集成 开发 环境 插件 


EGLIBC 


Hob 


Matchbox 


OpenEmbedded 核心 


Poky 


Pseudo 


描述 

应 用 开发 工具 为 用 户 空间 应 用 程序 提供 了 运行 在 由 Poky 构建 的 操作 系统 栈 上 的 
完整 的 开发 环境 。 应 用 开发 工具 包含 交 义 开发 工具 链 、QEMU Mir, Linux 内 核 
和 根 文件 系统 镜像 。Poky 直接 使 用 它 的 配置 文件 从 构建 环境 内 创建 和 打包 应 用 开发 
TA. 

AutoBuilder 通过 使 构建 系统 和 Buildbot 集成 来 自动 化 构建 。Yocto 项 目 质量 保证 
团队 使 用 AutoBuilder 持续 集成 和 用 一 套 标准 构建 目标 回归 测试 

BitBake 是 OpenEmbedded 构建 系统 的 构建 引擎 。BitBake 是 类 似 Make 或 者 Ant 的 
构建 工具 ， 它 聚焦 在 构建 软件 包 和 操作 系统 栈 

fa) tt AE VE VM Ware 虚拟 机 镜像 打包 的 在 Ubuntu Linux 之 上 的 完整 日 包含 的 
Poky 构建 系统 。 它 是 一 个 便捷 的 方法 ， 用 来 尝试 Poky 而 不 用 安装 Linux 构建 主机 并 
HÆ EMA Poky 

共 至 库 的 内 存 地 址 位 置 通常 是 在 执行 时 间 内 当 库 被 第 一 次 加 载 进 内 存 时 计算 出 来 
的 。 每 一 次 运行 依赖 于 共享 库 的 程序 时 ， 加 载 程 序 (loader) 需要 在 内 存 中 定位 库 。 
为 库 可 以 在 内 存 中 移动 ， 所 以 这 个 任务 造成 了 性 能 代价 增加 了 需要 被 解析 的 
共享 库 的 数量 。 预 先 链接 (prelinking) 通过 预先 计算 地 址 来 执行 可 行 性 程序 的 动态 链 
接 以 减少 开销 。 通 过 模仿 运行 时 链接 硕 ， 交 叉 预 先 链接 作为 交叉 开发 工具 链 的 部 分 
执行 这 个 过 程 

针对 Eclipse 集成 开发 环境 的 Yocto 项 目 插件 把 应 用 开发 工具 集成 进 Eclipse， 提 供 
用 于 用 户 空 间 应 用 的 交叉 开发 工作 流 。 这 个 插件 提供 针对 将 被 模拟 的 或 硬件 目标 所 
用 的 交叉 工具 链 以 及 根 文件 系统 的 集成 

EGLIBC # GNU C JẸ ( GLIBC) WJA INIRA., EA GLIBC 提供 了 相同 的 应 用 程 
序 编程 接口 (API)， 并 且 努 力 使 自己 和 GLIBC 在 源 代 码 和 二 进 制 方面 兼容 ， 但 是 它 
是 针对 移入 式 系 统 优化 的 。 优 化 包括 减少 的 内 存 占用 、 对 交叉 编译 和 交 又 测试 的 优 
化 的 支持 以 及 可 配置 的 组 件 。 虽然 EGLIBC 已 经 被 合并 进 了 GLIBC 并 且 结 束 了 生命 
周期 , 但 是 在 这 里 提 到 它 是 为 了 提供 上 下 文 和 历史 

Hob 是 针对 BitBake 的 图 形 用 户 界 面 。Hob 允许 从 方便 的 图 形 用 户 界 面 而 不 是 编辑 
文件 来 进行 构建 环境 的 配置 、 包 选择 以 及 镜像 配置 。 构 建 过 程 可 以 直接 从 Hob 启动 
并 且 被 监控 。Hob 是 被 OpenEmbedded 核心 包含 的 层 。 最 终 ，Yocto 项 目 团 队 将 停止 
Hob 而 倾 问 于 Toaster 

Matchbox 是 定位 于 和 能 入 式 设备 的 、 基 于 X Window 系统 的 开源 窗口 管理 希 。 它 和 
传统 条 面 窗口 管理 天 不 同 的 是 ， 它 同一 时 间 仅 仅 展示 一 个 充满 整个 屏 攻 的 窗口 。 这 
个 特性 使 得 它 适合 小 规格 设备 

OpenEmbedded 核心 (OpenEmbedded core) 是 在 OpenEmbedded 构建 系统 中 的 核心 
的 元 数据 集合 。 它 由 在 OpenEmbedded 驱动 的 系统 中 共享 的 BitBake 层 、 类 、 集 成 和 
实用 脚本 的 集合 组 成 。OpenEmbedded 核心 是 由 OpenEmbedded 项 目 和 Yocto 项 目 共 
同 维护 的 

Poky 是 Yocto 项 目的 参考 发 行 版 。 它 提供 了 一 套 预 先 配 置 的 舱 入 式 Linux 操作 系 
统 栈 的 蓝图 作为 工作 示例 ， 这 些 蓝 图 可 以 用 来 引导 实际 系统 开发 

构建 软件 包 频 繁 以 系统 管理 员 的 身份 要 求 系统 的 根 文件 系统 安装 文件 、 改 变 文 件 
属 主 或 者 访问 许可 、 创 建设 备 节 点 等 操作 。Pseudo 是 提供 虚拟 化 环境 的 应 用 ， 它 允 
许 这 种 操作 可 以 成 功 执行 ， 就 像 用 户 有 系统 管理 员 权 限 一 样 ， 即 使 他 是 普通 用 户 





(ZÈ) 
内 部 项 目 描述 

大 部 分 软件 包 被 配置 成 在 原生 系统 上 构建 。 在 交叉 开发 环境 中 频繁 构建 它们 要 求 配 
置 变 化 并 且 带 来 了 风险 一 一 构建 使 用 了 来 日 构 建 主 机 的 组 件 而 不 是 来 自 交 叉 构 建 环境 
Swabber 的 组 件 。 例 如 ， 在 make 文件 中 的 路 径 指 回 了 主机 系统 的 文件 而 不 是 在 交叉 构建 环境 中 
的 文件 。 这 样 的 交叉 构建 的 主机 污染 可 以 导致 难以 检测 的 、 不 仅仅 在 构建 时 而 且 在 执 
行 时 的 系统 失败 。Swabber 提供 了 用 于 检测 越过 构建 沙 盒 边 界 的 交叉 构建 访问 的 机 制 
Toaster 是 针对 BitBake 和 构建 系统 的 新 的 图 形 用 户 界 面 。 它 是 基于 网 页 的 ， 可 以 

被 部 署 成 市 有 远程 访问 的 分 布 式 构建 服务 





Toaster 


虽然 在 Yocto 项 目的 子 项 目 间 有 紧密 的 集成 ， 但 是 开发 者 确保 没有 交叉 的 依赖 且 子 项 目 是 可 以 互 操作 的 ， 并 且 其 也 可 以 独立 于 构建 系统 使 用 。 


2.3 ”历史 概览 





OpenEmbedded 和 Yocto 都 植 根 于 OpenZaurus 项 目 致力 于 提高 第 一 个 基于 Linux 的 个 人 数码 助理 (personal digital assistant) (夏普 
Zaurus SL-5000D) 代码 的 开源 项 目 。SL-5000D， 第 一 次 发 布 于 2001 年 ， 是 目标 定位 于 开发 者 的 设备 ， 并 且 夏 普 提 供 了 必要 工具 来 修改 和 更 新 设备 的 
ROM 代 码 。 起 初 ， 这 个 项 目 聚焦 在 重新 打包 现 有 ROM 代 码 以 使 得 它 对 开发 者 更 加 友好 。 随 着 时 间 推 移 ， 这 个 项 目 进化 了 ， 起 初 的 夏普 代码 被 从 源 代码 
构建 的 基于 Debian 的 Linux 发 行 版 完全 替换 。 它 迅速 友 展 了 构建 系统 ， 使 得 它 对 于 创建 新 设备 的 项 目 和 发行 版 独立 的 构建 系统 来 说 是 必要 的 。 
OpenEmbedded 项 目 诞生 了 。 


2.3.1 OpenEmbedded 
在 2003 年 ，OpenEmbedded 项 目 通过 整合 OpenZaurus 项 目的 成 果 和 来 自 其 他 类 似 目 标的 坐 入 式 Linux 项 目 〈 例 如 Familiar Linux 和 OpenSIMpad 
项 目 ) 的 贡献 而 启动 。 


OpenEmbedded 项 目 维护 了 构建 系统 以 及 摘 述 如 何 构建 软件 包 和 组 合 操作 系统 镜像 作为 通用 代码 基 的 元 数据 。 加 到 元 数据 目录 中 的 包 数 量 迅速 增长 
到 构建 5000 个 包 的 2100 个 菜谱 。 


在 2005 年 ， 项 目 团 队 决 定 拆 分 这 个 项 目 成 BitBake 构 建 系统 和 OpenEmbedded 元 数据 。 


OpenEmbedded 从 使 用 它 作为 构建 系统 的 各 种 Linux 发 行 版 获得 了 支持 。 其 中 就 有 4Angstrim 发 行 版 、Openmoko、WebOs 和 其 他 。 商 业 团体 让 他 
们 的 产品 采用 该 系统 ， 其 中 有 MontaVista 软 件 和 和 OpenedHand 一 一 开发 了 Poky Linux 发 行 版 的 创业 公司 。 


2.3.2 BitBake 
BitBake， 位 于 OpenEmbedded 和 Yocto 项 目的 Poky 参 考 友 行 版 核心 的 构建 引擎， 是 从 Portage (Gentoo Linux 的 构建 和 包 管 理 系统 ) 派生 而 来 。 
Portage 包 含 两 个 组 件 : 
ebuild 是 处 理 从 源 代码 构建 软件 包 并 安装 它们 的 实际 的 构建 系统 。 
- emerge 是 到 ebuild 的 接口 以 及 管理 ebuild 包 仓库 、 解 决 依赖 性 和 更 多 工作 的 工具 。 


所 有 的 Portage 都 是 用 Python 写 的 。BitBake 从 Portage 进 化 而 来 ，BitBake 为 使 用 原生 和 交叉 开发 工具 链 构 建 软件 包 而 扩展 了 Portage、 支 持 多 个 包 
管理 系统 和 其 他 针对 交叉 构建 所 必需 的 其 他 功能 性 。 


BitBake 使 用 和 Portage 构 建 脚本 相同 的 元 数据 语法 ， 但 是 引入 了 新 的 特性 ， 例 如 由 类 提供 的 继承 机 制 、 追 加 (appending) 菜谱 和 全 局 配置 文件 


oe 
wo 


2.3.3 Poky Linux 
OpenEmbedded 极 大 地 简化 了 为 嵌入 式 设 备 (但 不 限于 此 ) 构建 Linux 操 作 系 统 栈 的 过 程 。 然 而 ， 对 于 修改 和 调整 系统 来 创建 不 同 的 友 行 版 和 移植 
系统 到 新 的 硬件 来 说 ， 它 仍然 是 一 个 市 有 相当 陡峭 的 学 习 曲 线 的 挑战 。 


软件 创业 公司 OpenedHand 为 内 部 使 用 开发 了 Poky Linux 一 一 多 功能 的 开发 平台 和 针对 移动 设备 的 Linux 发 行 版 。Poky Linux 为 该 公司 应 用 于 嵌入 
式 设 备 的 Matchbox 窗 口 管 理 器 提供 了 测试 平台 。Matchbox 最 显著 地 被 Nokia 770 和 N800 平 板 设 备 、Openmoko 的 Neo1973 和 “每 个 儿童 一 台 笔 记 
本 ”项 目 (One Laptop Per Child, OLPC) 的 XO 笔记 本 电脑 所 使 用 。 


Poky Linux 是 由 OpenEmbedded 构 建 的 ， 它 提供 了 更 加 直观 的 方法 来 为 目标 设备 配置 操作 系统 镜像 。 它 也 提供 了 一 些 针对 易于 调整 的 目标 设备 镜 
像 的 蓝图 。 因 为 Poky Linux 是 开源 的 ， 所 以 它 迅 速 地 被 其 他 人 采用 以 便 构 建 谱 入 陈设 备 。 


英特尔 公司 在 2008 年 收购 了 OpenedHand， 目 的 是 进一步 友 展 Poky Linux 作 为 用 于 众 入 式 设 备 的 通用 的 发 行 版 。 


2.34 Yoctoln 


为 了 构建 Poky Linux 来 支持 许多 不 同 的 架构 和 硬件 平台 ， 英 特 尔 那 时 一 直 在 寻找 其 他 的 商业 团体 一 一 特别 是 其 他 的 半导体 生产 高 和 罕 入 式 Linux 公 司 
一 一 来 支持 这 个 项 目 并 且 为 其 做 贡献 。 因 为 瑞 特 尔 是 心 片 市 场 上 的 主导 玩家 ， 所 以 这 证 明 对 英特尔 来 说 ， 让 它 的 竞争 对 手 和 其 他 公司 来 支持 它 改 进 Poky 
Linux 是 困难 的 。 


在 2010 年 ， 瑞 特 尔 与 Linux 基 金 会 接洽 ,希望 在 基金 会 的 赞助 下 ， 建 立 中 立 管理 的 协作 项 目 ， 涉 及 开源 社区 ， 特 别 是 OpenEmbedded 项 目 。 


Linux 基 人 金 会 在 2010 年 10 月 26 日 公开 宣布 Yocto 项 目 启动 。 在 2011 年 3 月 1 日 ，Linux 基 金 会 宣布 Yocto 项 目 与 OpenEmbedded 的 技术 对 准 
(alignment) 以 及 多 个 公司 协作 者 对 该 项 目的 支持 。 这 个 声明 被 2011 年 4 月 6 日 的 男 一 个 报道 所 跟 进 ， 主 要 内 容 包 括 Yocto 项 目 指 导 组 (Yocto Project 
Steering Group) 的 信息 和 第 一 个 Yocto 项 目 发 布 。 


2.3.5 OpenEmbedded 和 Yocto 项 目的 天 系 


在 OpenEmbedded 和 Yocto 项 目 之 间 的 技术 对 准 对 这 两 个 项 目 都 市 来 了 一 些 主 要 的 改进 : 





WEA (aligned development) : 在 开源 项 目 中 常见 的 问题 是 分 裂 一 有 相同 的 根源 和 类 似 目标 的 两 个 项 目 派生 并 且 产 生 隔 闵 。 资 源 被 分 害 
并 且 最 终 在 两 个 分 支 上 重复 努力 ， 提 供 类 似 的 功能 。 最 终 ， 用 户 和 支持 者 被 强制 在 这 两 个 努力 之 间 做 出 选择 。OpenEmbedded 和 Yocto 项 目的 紧 窗 对 准 保 
证 了 用 户 可 以 获得 这 两 个 项 目的 好 处 。 


- BitBake 元 数据 层 : 元 数据 层 能 使 菜谱 和 配置 文件 逻辑 分 组 成 可 以 被 轻松 纳入 并 迁移 到 不 同 构建 环境 的 结构 。 元 数据 层 也 简化 了 依赖 管理 ， 这 是 在 
构建 操作 系统 栈 时 的 复杂 任务 。 


. OpenEmbedded 核 心 元 数据 层 (openEmbedded core metadata layer) : OpenEmbedded 和 Yocto 项 目 开 发 团队 同意 创建 这 两 个 项 目 共享 并 且 
包含 所 有 基准 菜谱 和 配置 设 定 的 通用 的 元 数据 层 。 然 后 ， 每 个 项 目 根据 其 目标 增加 额外 的 元 数据 层 。 


虽然 OpenEmbedded 和 Yocto 项 目 之 间 有 紧密 的 协作 ， 但 是 这 两 个 项 目 是 独立 的 实体 。 它 们 都 是 开源 项 目 并 且 都 受到 了 由 开源 开发 者 和 商业 团体 组 
成 的 社区 的 支持 。 


OpenEmbedded 聚 焦 在 尖 疹 技术 、 莱 谱 和 一 大 套 针对 不 同 硬件 平台 的 板 广 持 包 。Yocto 项 目 聚 焦 在 构建 系统 本 身 和 针对 交叉 开发 的 工具 化 上 。 
Yocto 项 目的 目标 是 提供 强大 却 简单 易 用 并 且 测 试 民 好 的 工具 以 及 核心 的 元 数据 集合 ， 以 局 动 嵌 入 式 系 统 开 发 。 额 外 的 板 支 持 包 和 其 他 组 件 是 通过 
OpenEmbedded 和 Yocto 项 目 生态 系统 来 提供 的 。 


OpenEmbedded 项 目 也 维护 了 层 的 索引 ， 这 是 可 检索 的 层 、 菜 谱 和 机 器 的 数据 库 。 要 寻找 构建 特定 的 开源 包 的 菜谱 ， 疝 层 索 引 输 入 名 字 ， 可 能 的 情 
况 是 某 个 人 已 经 为 它 创 建 了 菜谱 。 


24 Yocto 项 目 术 语 


表 2-3 定 义 了 一 套 经 单 和 Yocto 项 目 联合 使 用 并 且 贯 穿 于 Yocto 项 目的 术语 。 贯 穿 本 书 ， 我 们 一 致 性 地 按照 这 里 提供 的 定义 来 使 用 这 些 术语 。 


术语 


追加 文件 (append file) 


BitBake 


板 文 持 包 ( Board Support 
Package, BSP) 


类 (class) 


配置 文件 


交叉 开发 工具 链 (cross- 
development toolchain ) 


表 2-3 Yocto 项 目 术 语 


摘 述 

仍 加 文件 扩展 现 有 的 沫 谱 。BitBake 逐 字 追加 该 追加 文件 的 内 容 到 对 应 的 菜谱 ， 在 解 
析 前 创建 单一 文件 。 追 加 文件 中 的 变量 可 以 覆盖 对 应 菜谱 中 定义 的 相同 的 变量 。 追 加 文 
件 使 用 bbappend 后 级 

作为 OpenEmbedded 构建 系统 中 的 构建 引 警 ，BitBake 是 任务 执行 器 和 调度 需 。 它 的 
输入 是 元 数据 (例如 配置 文件 和 菜谱 )， 通 过 这 些 元 数据 ，BitBake 处 理 被 控制 

板 文 持 包 中 的 文档 、 二 进 制 、 代 人 码 和 其 他 特定 于 实现 的 支持 数据 使 一 个 特定 的 操作 系 
统 运 行 在 特定 的 目标 人 硬件 系统 上 。 有 时 ， 板 文 持 包 也 会 包含 完整 的 根 文件 系统 和 交叉 开 
发 环境 ， 以 创建 运行 在 目标 硬件 平台 上 的 应 用 程序 

BitBake 术语 中 ， 类 是 提供 逻辑 封装 和 基本 继承 机 制 ， 使 得 通常 用 到 的 模式 被 定义 一 
次 而 在 多 个 菜谱 中 使 用 的 元 数据 文件 。BitBake 类 文件 使 用 bbclass 后 级 

配置 文件 是 提供 影响 构建 过 程 的 全 局 定义 和 变量 设置 的 BitBake 元 数据 文件 

交 又 开发 工具 链 是 一 套 软 件 开发 工具 ， 它 允许 针对 目标 系统 的 软件 开发 利用 不 同 的 
涤 构 而 不 是 开发 主机 。 在 这 个 上 下 文中 ， 染 构 是 指 不 同 的 CPU 指令 集 (例如 ，ARM、 
MIPS、PowerPC、x86 ) 和 不 同 的 位 大 小 〈 例 如， 8 位、16 位 、32 位 和 64 位 )。 通 篆 ， 
交叉 开发 工具 链 包 括 一 个 或 者 多 个 语言 编译 副 、 汇 编程 序 、 链 接 硕 ， 以 及 特定 于 目标 染 
构 的 调试 侨 、 模 拟 各 和 其 他 工具 





(25 ) 


术语 HAIR 
NERF, A EEE, BAAR EMRET (bootloader), HER 
镜像 (image) 统 内 核 以 及 将 被 复制 到 存储 介质 并 且 目 标 系 统 可 以 由 此 启动 和 运行 的 根 文 件 系 统 。 术 语 


“镜像 ”也 可 以 仅 用 于 表示 操作 系统 内 核 (内 核 镜 像 ) 或 者 根 文件 系统 ( 根 文 件 系 统 镜像 ) 
在 BitBake 术语 中 ， 层 是 组 织 进 文件 和 目录 结构 的 元 数据 (配置 文件 、 羔 谱 等 ) 集合 。 
BitBake 可 以 包含 层 来 扩展 它 的 功能 。Yocto 项 目 板 支持 包 也 是 作为 层 来 提供 的 
在 BitBake 术语 中 ， 元 数据 包括 所 有 命令 BitBake 如 何 执行 构建 过 程 的 文件 。BitBake 
元 数据 包括 类 、 羔 谱 (和 追加 文件 ) 以 及 配置 文件 
作为 在 OpenEmbedded 构建 系统 中 由 OpenEmbedded 和 Yocto 项 目 共 享 的 一 套 核 心 元 
数据 ，OpenEmbedded 核心 是 由 OpenEmbedded 项 目 和 Yocto 项 目 共同 维护 的 BitBake Jz 
包 是 软件 包 ， 其 中 包含 可 执行 的 二 进 制 文件 、 库 、 文 档 、 配 置信 息 和 其 他 文件 ， 这 些 
文件 加 循 “操作 系统 的 包 管 理 系统 可 以 安 疙 或 锰 载 ”的 特定 格式 。 包 通常 也 包括 与 包 管 
包 (package ) SH AACA HE A I AR BIH AA A ee A a AT AS ARS FI E o 
Yocto 项 目 还 使 用 术语 “ 包 ” 来 表示 用 于 建立 各 目的 软件 包 的 沫 详 和 其 他 元 数据 。 依 
不 于 上 下 文 ， 该 术语 指 的 是 实际 的 软件 包 或 者 构建 软件 包 的 元 数据 
包 管 理 系 统 是 一 套 软件 工具 集合 ， 这 些 工 具 用 于 为 计算 机 操作 系统 目 动 化 安 猴 、 升 
包 管 理 系 统 (package | 级 、 配 置 和 删除 软件 包 的 过 程 。 它 通常 维护 计算 机 上 已 安 疤 的 软件 的 数据 库 ， 包括 版 本 
management system ) HAL, 、 依 赖 、 不 兼容 性 以 及 更 多 ， 以 防止 由 软件 不 匹配 和 缺失 的 先决 条 件 而 导致 的 系统 
故障 
Poky 是 Yocto 项 目的 参考 发 行 版 ， 也 是 由 构建 系统 创建 的 默认 Linux 发 行 版 的 名 字 。 
Poky Poky 下 载 包 包含 OpenEmbedded 构建 系统 和 用 于 创建 名 字 为 Poky 的 样 例 让 和 人 式 发 行 版 
的 额外 的 元 数据 
菜谱 是 包含 用 于 BitBake 构建 特定 软件 包 的 指令 的 元 数据 文件 。 通 过 它 的 指令 ,菜谱 
描述 从 哪里 获取 源 代码 、 应 用 什么 补丁 以 及 如 何 应 用 这 些 补 丁 、 如 何 构 建 二 进 制 和 相关 
菜谱 (recipe) 文件 、 如 何在 目标 系统 上 安装 构建 的 结果 、 如 何 创建 打 包 的 软件 包 以 及 更 多 。 亲 谱 也 描 
述 了 在 构建 中 以 及 运行 时 对 其 他 软件 包 的 依赖 性 ， 因 而 创建 构建 过 程 所 需要 的 菜谱 的 逻 
HJER. KEH bb 文件 后 级 
BitBake Si "J HE? A BitBake 在 构建 过 程 中 执行 的 可 执行 元 数据 或 者 代码 。 执 行 步 
又 可 以 分 组 成 元 数据 果 数 。 元 数据 晒 数 可 以 通过 插入 BitBake 任务 列表 而 被 声明 为 任务 
在 软件 开发 中 ， 特 别 是 在 开源 软件 开发 方面 ， 上 洲 指 回 发 起 人 ， 也 就 是 软件 的 原始 作 
者 或 者 维护 者 。 通 第 ， 这 个 术语 被 用 作 限 定 词 ， 例 如 上 游 仓库 和 上 游 补 丁 





层 (layer) 
元 数据 (metadata) 


OpenEmbedded 核心 


任务 (task) 


WF (upstream) 


2.5 AA 


Yocto 项 目 是 与 误 入 式 Linux 软 件 开发 相关 的 项 目 系列 。 它 的 核心 是 OpenEmbedded 构 建 系 统 和 Poky 参 考 上 发 行 版 。Poky 开 始 是 由 OpenedHand 作 
为 Poky Linux 开 发 的 ， 然 后 ， 它 进化 成 了 Yocto 项 目 一 一 在 Linux 基 金 会 支持 下 的 协作 项 目 。 它 由 企业 和 独立 软件 开发 者 所 支持 ， 它 将 技术 与 
OpenEmbedded 对 准 而 形成 完 泛 的 交付 于 开 友 嵌入 式 Linux 系 统 的 最 先进 的 工具 的 社区 。 


上 上 手 Yocto 项 目 和 下 载 构建 器 具 并 从 VMWare 虚 拟 机 管理 器 中 启动 它 一 样 简 单 。 哩 然 构 建 器 具 对 于 严肃 的 开发 来 说 并 不 是 值得 推荐 的 ， 但 是 它 提 供 
了 对 于 OpenEmbedded 构 建 系统 的 好 的 指导 而 不 需要 设置 Linux 构 建 主机 。 


安 半 可 用 于 Poky 的 Linux 构 建 主机 需要 更 多 的 步骤 但 是 避免 了 虚拟 机 的 开销 以 及 性 能 影响 。 
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第 3 章 OpenEmbedded 构 建 系统 


Poky 是 Yocto 项 目的 参考 发 行 版 。 它 包 仿 OpenEmbedded 构 建 系 统 。 它 提供 了 构建 Linux 操 作 系统 栈 所 要 求 的 全 部 必要 的 工具 、 菜 谱 和 配置 数据 。 
正如 我 们 在 前 面 一 章 中 看 到 的 ，Poky 是 打包 成 简单 包 的 几乎 目 包 含 的 系统 。 仪 仪 有 少量 额外 的 组 件 需 要 安 妆 在 构建 主机 上 以 使 用 Poky。 


本 章 先 分 析 针 对 开源 软件 包 的 典型 的 工作 流 。 然 后 解释 OpenEmbedded 工 作 流 是 如 何 将 各 个 软件 包 的 构建 与 创建 完整 的 Linux 操 作 系统 栈 和 可 启动 
文件 系统 镜像 的 过 程 集成 起 来 的 。 有 了 这 些 知识 ， 我 们 融 可 以 详细 了 解 Poky 架 构 及 其 组 件 了 。 


3.1 ”构建 开源 软件 包 


如 果 你 先前 曾 为 Linux 主 机 系统 构建 过 开源 软件 包 ， 那 么 你 可 能 已 经 注意 到 了 ， 工 作 流 遵循 特定 的 模式 。 这 个 工作 流 的 一 些 步 又 你 自己 执行 ， 而 其 他 
的 通 剃 是 通过 某 种 自动 化 (例如 Make 或 者 其 他 开源 到 二 进 制 的 构建 系统 ) 来 实施 的 。 


获取 : 获取 源 代码 。 

解压 : 解压 源 代码 。 

ANJ: 针对 缺陷 修复 和 增加 的 功能 应 用 补丁 。 

- 配置 : 依据 环境 准备 构建 过 程 。 

` 构建 : 编译 和 连接 。 

安装 : 复制 二 进 制 和 辅助 文件 到 它们 的 目标 目录 。 
FJB: 为 在 其 他 系统 上 安装 而 打包 二 进 制 和 辅助 文件 。 


如 果 你 正在 构建 仅仅 用 在 你 用 来 构建 的 主机 系统 上 的 软件 包 ， 那 么 通常 你 将 在 系统 上 安 痰 了 二 进 制 以 后 束 停 止 了 。 然 而 ， 如 果 你 希望 为 了 在 其 他 系 
统 上 安 半 和 使 用 而 分 友 二 进 制 ， 那 么 你 将 也 包括 打包 步骤 ， 它 创建 可 以 被 包 管 理 系统 安 少 的 包 。 


让 我 们 来 看 看 各 个 步骤 。 


3.1.1 获取 


所 有 的 一 切 都 是 以 获取 针对 软件 包 的 源 代码 开始 。 通 常 ， 开 源 软 件 项 目 有 一 个 下 载 区 域 ， 从 那里 源 代码 、 指 令 、 文 档 以 及 其 他 信息 可 以 以 包 的 形式 
被 下 载 ， 包 通常 也 是 压缩 的 。 理 论 上 听 起 来 很 像 一 个 简单 的 任务 ， 但 事实 上 需要 大 量 对 细节 的 关注。 当下 载 源 代码 包 时 ， 没 有 通用 的 要 遵循 的 约定 。 


当然 ， 每 个 开源 项 目 有 自己 的 统一 资源 定位 地 址 (Uniform Resource Locator, URL) 来 访问 它 的 网 站 、 文 件 服务 器 和 下 载 区 域 。 另 外 ， 下 载 可 能 
是 通过 一 个 或 者 更 多 协议 访问 的 ,例如 HTTP、HTTPS、FTP、SFTP 和 其 他 协议 。 一 些 项 目 可 能 也 提供 对 已 发 布 版 本 和 来 自 Git、Subversion、 并 发 版 本 
系统 (Concurrent Versions System, CVS; 也 被 称 为 并 发 修改 系统 ) 等 的 源 代码 控制 管理 系统 (Source Control Management, SCM) 的 源 代码 开 


发 分 支 的 访问 。 
通常 ， 从 远程 位 置 (例如 下 载 站 后 或 者 仓库 ) 获取 的 源 可 能 由 存储 在 本 地 文件 系统 上 的 补丁 和 辅助 文件 来 补充 。 


对 于 如 OpenEmbedded 构 建 系统 这 样 的 目 动 化 构建 系统 来 说 ， 这 种 获取 源 代码 方式 的 变化 性 意味 着 它 需 要 的 是 灵活 ， 并 且 其 能 够 为 开 友 者 最 透明 地 
处 理 这 种 变化 性 。 


3.1.2 解压 


在 源 代码 被 下 载 后 ， 必 须 将 其 解 开 并 且 把 它 从 下 载 位 置 复制 到 你 将 构建 它 的 位 置 。 通 常 ， 开 源 软件 包 被 封装 进 包 ， 大 部 分 情况 下 封装 成 压缩 的 tar 
包 , 但 是 CPIO 和 其 他 序列 化 多 个 文件 成 单一 包 的 格式 也 是 在 使 用 中 的 。 最 常用 的 压缩 格式 是 GZIP 和 BZIP， 但 是 一 些 项 目 使 用 其 他 的 压缩 方案 。 表 一 次 
说 明 ， 构 建 系统 必须 能 够 目 动 检测 源 包 的 格式 并 且 使 用 正确 的 工具 来 解压 它 。 


如 果 源 是 从 源 控制 管理 系统 获得 的 ， 那 么 解压 包 一 般 意味 着 把 它们 从 源 控制 管理 系统 检 出 到 BitBake 构 建 它们 的 地 方 。 


3.1.3 打 补 丁 


打 补 本 是 通过 增加 、 删 除 和 变更 源 文 件 来 修改 源 代码 的 过 程 。 有 很 多 理由 说 明 为 什么 源 代码 在 构建 前 可 能 要 打 补 丁 : 应 用 缺陷 和 安全 修复 、 增 加 功 
能 性 、 提 供 配 置信 息 、 为 交叉 编译 做 出 调整 等 。 例 如 ，Linux 内 核 需 要 提供 了 数 百 个 用 于 内 核 构 建 系统 的 配置 项 的 文件 ， 例 如 目标 架构 、 硬 件 信息 、 设 备 
驱动 等 。 


应 用 补丁 可 能 与 复制 文件 到 源 代码 的 目录 结构 中 一 样 简 单 。 在 这 种 情况 下 ， 构 建 系统 当然 需要 知道 把 文件 复制 到 哪里 去 。 通 囊 ， 补 本 是 使 用 补丁 工 
具 来 被 应 用 的 ， 它 把 用 diff 工 具 创建 的 补丁 文件 作为 输入 。diff 将 原始 文件 和 修改 过 的 文件 进行 比较 并 且 创 建 了 不 但 包含 变 化 而 且 包含 如 文件 的 名 字 和 路 
径 、 修 改 的 精确 位 置 和 上 下 文 等 元 数据 的 差异 文件 。 这 个 文件 的 格式 是 标准 化 的 ， 被 称 为 统一 格式 (unified format) 。 使 用 了 统一 格式 的 补丁 文件 可 
以 包含 一 次 打 多 个 文件 补丁 的 信息 ， 并 且 它 可 以 增加 或 者 删除 完整 文件 。 因 为 所 有 关于 文件 被 修改 、 增 加 或 者 删除 的 信息 都 是 在 补丁 文件 中 包含 的 ， 所 
以 构建 系统 不 需要 知道 任何 天 于 要 打 补 丁 的 源 代 码 的 目录 结构 。 


补丁 被 应 用 的 顺序 是 很 重要 的 ， 因 为 补丁 可 能 是 互相 依赖 的 。 以 正确 的 顺序 应 用 大 量 补丁 可 能 是 困难 的 任务 。Quilt 补 丁 管理 系统 通过 创建 补丁 栈 来 
维护 顺序 从 而 极 大 地 简化 了 这 个 任务 。 在 众多 其 他 功能 中 ，Quilt 也 人 允许 撤回 已 经 应 用 的 补丁 和 所 有 依赖 补丁 。Quilt 是 一 系列 最 开始 为 Linux 内 核 开 发 而 
现在 也 经 常 被 其 他 开源 项 目 使 用 的 shell 脚 本 。 


3.14 MA 


以 源 代码 的 形式 提供 软件 包 ， 服 务 了 这 样 的 目的 : 用 户 可 以 自己 针对 大 范围 的 目标 系统 构建 软件 。 随 变化 性 而 来 的 是 要 求 针 对 软件 包 的 构建 环境 能 
够 针对 目标 系统 而 被 正确 配置 的 多 样 性 。 精 确 的 配置 对 于 构建 主机 的 CPU 架构 不 同 于 目标 系统 的 CPU 架构 这 一 交叉 构建 环境 是 特别 重要 的 。 


许多 软件 包 现 在 为 配置 而 使 用 GNU 构 建 系统 ， 也 被 称 作 Autotools。Autotools 是 一 套 目标 是 使 源 代码 软件 包 可 以 移植 到 很 多 类 UNIX 系 统 的 工具 。 
Autotools 是 反映 目标 系统 和 依赖 的 变化 性 和 多 样 性 的 相当 复杂 的 系统 。 简 言 之 ，Autotools 从 一 些 列 具有 特殊 源 代码 体 特征 的 输入 文件 中 创建 
configure 脚 本 。 通 过 一 系列 处 理 步骤 ，configure 创 建 了 特别 用 于 目标 系统 的 makefile。Autotools 经 常 因 为 难以 使 用 而 受到 批评 。 这 种 困难 性 ， 当 
然 ， 依 赖 于 视角 。 从 用 户 的 视角 看 ， 执 行 单 一 脚本 来 配置 针对 目标 系统 的 源 代码 包 构 建 环境 当然 是 巨大 的 收益 。 和 希望 向 他 们 的 软件 用 户 提供 便利 性 的 开 
发 者 需要 理解 Autotools 的 工作 方式 以 及 如 何 正确 创建 必要 的 输入 文件 。 而 且 ， 它 值得 努力 ， 并 且 使 用 类 似 针对 许多 不 同 目标 系统 的 OpenEmbedded 构 
建 系统 的 自动 化 构建 系统 极 大 地 简化 构建 软件 包 。 


一 些 软件 包 使 用 它们 目 己 的 配置 系统 。 在 这 种 情况 下 ， 目 动 化 的 构建 系统 需要 提供 对 应 调整 配置 步骤 的 灵活 性 。 


3.1.5 ”构建 


大 部 分 的 软件 包 使 用 Make 来 从 源 代码 构建 二 进 制 文件 例如 可 执行 程序 文件 和 库 以 及 辅助 文件 。 一 些 软件 包 可 能 使 用 其 他 工具 ， 例 如 CMake 或 者 针 
对 使 用 了 Qt 图 形 库 的 软件 包 的 qmake。 


3.16 BR 


安装 步 又 复制 二 进 制 、 库 、 文 档 、 配 置 和 其 他 文件 到 目标 系统 的 正确 位 置 。 程 序 文件 通常 被 安装 进 /usr/bin (对 于 用 户 程 序 ) 和 /usr/sbin (对 于 系 
统管 理 程序 ) 。 库 被 复制 到 /usr/lib 以 及 位 于 /usr/lib 之 内 的 特定 于 应 用 的 子 目 录 。 配 置 文件 通常 被 安装 到 /etc。 昌 然 天 于 在 哪里 安装 特定 文件 有 常用 的 惯 
例 ， 但 是 一 些 软件 开发 者 有 时 选择 不 同 的 目录 来 安装 属于 他 们 软件 包 的 文件 。 文 件 系统 层级 标准 (filesystem Hierarchy Standard, FHS) 

(https://wiki.linuxfoundation.org/en/FHS) 是 针对 用 于 UNIX 操 作 系统 的 文件 系统 布局 的 规格 说 明 。 


大 部 分 软件 包 提 供 作 为 它们 makefile 一 部 分 的 install 目 标 ， 它 执行 安装 步骤 。 正 确 写 下 的 安 六 目标 使 用 安 六 工具 来 从 构建 环境 中 复制 文件 到 它们 各 
目的 目标 目录 。 安 兴工 具 也 可 以 在 复制 文件 时 设置 文件 属 主 和 权限 。 


3.1.7 打包 


打包 是 捆绑 软件 、 二 进 制 和 辅助 文件 到 单一 用 于 分 友和 在 目标 系统 上 直接 安 濠 的 包 文件 的 过 程 。 打 包 可 以 像 压 缩 的 tar 包 一 样 简单 ， 然 后 用 户 可 以 在 
目标 系统 上 进行 获取 。 


为 了 便利 性 和 可 使 用 性 ， 大 部 分 软件 包 捆 绑 它 们 的 文件 和 安 妆 程序 或 者 包 管理 系 统一 起 使 用 。 一 些 系统 包含 安 丢 软件 和 软件 包 并 且 创 建 用 于 目 包含 
安 半 的 可 执行 文件 。 其 他 系统 依赖 于 已 经 安 半 在 目标 系统 上 的 包 管 理 器 ， 并 且 仪 仪 捆绑 实际 的 软件 和 用 于 包 管 理 器 的 元 数据 信息 。 所 有 系统 的 共同 点 
是 ,它们 不 但 从 软件 包 中 复制 文件 到 目标 系统 而 且 验 证 依赖 性 和 系统 配置 以 避免 最 终 导 致 系统 不 可 操作 的 不 匹配 。 


Linux 系 统 通 常 依赖 作为 友 行 版 部 分 的 包 管理 系统 而 不 是 使 用 自 包 含 的 安 湾 包 。 好 处 是 ， 包 管理 器 ， 作 为 唯一 的 实例 ， 维 护 系 统 上 的 软件 数据 库 ， 并 
上 且 软 件 包 在 尺寸 上 更 小 ， 因 为 它们 不 需要 包含 安装 软件 。 然 而 ， 对 每 个 Linux 发 行 版 来 说 ， 维 护 者 决定 它 的 包 管理 系统 ， 这 需要 软件 包 针对 不 同 的 目标 系 
统 而 被 打包 多 次 。 


对 Linux 发 行 版 来 说 最 常用 的 包 管 理 系统 是 RPM 包 管 理 器 (RPM; 最 初 是 红 帽 包 管理 器 ) 和 dpkg (Debian 的 包 管理 程序 ) 。 对 伐 入 式 设 备 来 
说 ，ltsy 包 管理 系统 (pko) 已 经 获得 了 流行 。1Ipkg 是 类 似 dpkg 的 轻 量 级 系统 。1Ipkg 的 开发 是 被 中 断 的 ， 并 且 很 多 一 直 使 用 ipkg 的 让 入 式 项 目 现在 在 使 
用 opkg， 它 是 由 Openmoko 项 目 从 ipkg 派 生出 来 的 。Opkg 是 以 C 编 写 的 一 一 它 是 被 Yocto 项 目 积极 维护 的 并 且 被 OpenEmbedded 和 许多 其 他 项 目 使 
用 着 。 


安 半 和 打包 不 一 定 是 连续 的 步骤 ; 并 且 它 们 也 是 可 选 的 。 如 果 你 正在 构建 本 地 使 用 而 非 再 分 太 的 软件 包 ， 那 么 不 需要 打包 软件 。 如 果 你 是 包 维护 者 
并 且 创建 用 于 再 分 友 的 包 ， 那 么 你 可 能 不 需要 执行 在 构建 系统 上 安 委 软件 包 的 步骤 。 


这 里 简 述 的 步骤 本 质 上 是 相同 的 ， 不 管 你 是 在 原生 地 构建 软件 包 还 是 执行 交叉 构建 。 然 而 ， 在 设置 和 配置 构建 环境 以 及 为 交叉 构建 构建 包 时 ， 你 必 
须要 考虑 错综复杂 的 事物 。 通 过 本 书 ， 我 们 解决 交叉 构建 软件 的 复杂 性 。 


3.2 OpenEmbedded 工 作 流 


图 3-1 说 明了 OpenEmbedded 工 作 流 。 这 个 工作 流 不 是 BitBake 固 有 的 。BitBake 完 全 不 建立 工作 流 。 工 作 流 和 它 的 配置 是 被 元 数据 定义 的 ， 它 被 组 
织 成 不 同类 别 的 文件 。 
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图 3-1 OpenEmbedded 工 作 流 


3.2.1 元 数据 文件 
元 数据 文件 被 划分 成 两 个 类 别 : 配置 文件 和 菜谱 。 
配置 文件 


配置 文件 包含 简单 变量 赋值 形式 的 全 局 构建 系统 设置 。BitBake 在 全 局 数据 字典 中 维护 变量 设 定 ， 并 且 它 们 可 以 在 任何 元 数据 文件 中 被 访问 到 。 变 量 
可 以 被 设置 在 配置 文件 中 并 且 被 男 外 的 配置 文件 覆 藉 。 菜 谱 可 以 设置 和 获 薪 变量 ,但 是 在 菜谱 中 所 做 的 赋值 对 于 菜谱 来 说 仍然 是 本 地 的 。BitBake 对 于 赋 
值 元 数据 变量 及 用 了 特殊 的 语法 。 赋 值 和 履 盖 元 数据 变量 的 优先 级 由 多 个 因素 决定 ， 例 如 层 结 构 、 层 优先 级 、 文 件 解析 顺序 以 及 赋值 语法 。 我 们 将 在 第 4 
草 中 解释 BitBake 元 数据 语法 和 优先 级 的 细节 。 


BitBake 区 分 多 个 不 同类 型 的 配置 文件 ， 但 是 都 有 相同 的 文件 扩展 名 .conf。 
BitBake 主 配置 文件 (bitbake.conf) 


BitBake 的 主要 配置 文件 被 命名 为 bitbake.conf。BitBake 期 望 这 个 文件 存在 于 在 它 的 元 数据 搜索 路 径 下 列 出 的 所 有 目录 中 。 这 个 文件 包含 所 有 默认 
配置 设置 。 其 他 配置 文件 和 菜谱 通常 根据 它们 的 特定 需求 而 覆 薪 这 个 文件 中 的 一 些 变量 设置 。 


文件 bitbake.conf 是 OpenEmbedded 核 心 (OpenEmbedded Core) 元 数据 层 的 部 分 ， 并 且 可 以 在 那个 层 的 conf 配 置 文件 子 目录 中 找到 |。 
层 配置 文件 (layer.conf) 


OpenEmbedded 构 建 系统 使 用 层 来 组 织 元 数据 。 层 本 质 上 是 目录 和 文件 的 层级 结构 。 每 个 层 有 目 己 的 名 字 为 layer.conf 的 配置 文件 。 这 个 文件 包含 
了 针对 这 个 层 的 菜谱 文件 的 路 径 设置 和 文件 模式 。 文 件 layer.conf 可 以 在 层 的 conf 子 目录 中 找到 |。 


构建 环境 层 配置 (bblayers.conf) 


构建 环境 需要 告诉 BitBake 它 需要 什么 层 来 针对 它 的 构建 过 程 。 文 件 bblayers.conf 提 供 BitBake 关 于 什么 层 要 包含 在 构建 过 程 中 以 及 在 哪里 找到 文件 
路 径 的 信息 。 每 个 构建 环境 有 自己 的 bblayers.conf 文 件 ， 它 可 以 在 构建 环境 的 conf 子 目录 中 找到 。 


构建 环境 配置 (local.conf ) 


构建 环境 的 本 地 配置 是 通过 名 为 local.conf 的 配置 来 提供 的 。 文 件 local.conf 包 含 应 用 到 特定 构建 环境 的 设置 ， 例 如 到 下 载 位 置 、 构 建 输出 和 其 他 文 
件 的 路 径 ; 针对 目标 系统 的 配置 设置 ， 例 如 目标 机 器 、 包 管理 系统 以 及 分 友 策略 ; 和 许多 其 他 设置 。 文 件 local.conf 可 以 在 构建 环境 的 conf 子 目录 中 找 


到 。 
发 行 版 配置 (<distribution-name>.conf) 


发 行 版 配置 文件 包含 反映 应 用 到 由 OpenEmbedded 构 建 系统 构建 的 特殊 友 行 版 的 策略 的 变量 设置 。 对 于 Poky 参 考 友 行 版 ， 默 认 的 镜像 名 字 也 是 
Poky， 它 的 配置 设置 包含 在 名 为 poky.conf 文 件 中 。 友 行 版 策略 设置 通常 包含 工具 链 、C 库 和 友 行 版 名 字 等 。 友 行 版 通过 设置 在 构建 环境 的 local.conf 文 
件 中 的 变量 DISTRO 来 被 选择 。 当 然 ， 不 限于 由 Poky 作 为 参考 所 提供 的 友 行 版 策略 。 你 可 以 创建 你 自己 的 发 行 版 策略 文件 并 且 在 构建 环境 中 使 用 它 。 


发 行 版 配置 文件 通常 在 定义 发 行 版 的 层 (例如 meta-yocto 层 ) 的 conf/distro 子 目录 中 找到 。 
机 器 配置 (<machine-name>.conf) 


OpenEmbedded 工 作 流 最 强力 的 特性 之 一 是 它 能 够 严格 区 分 构建 过 程 中 依赖 于 特殊 硬件 系统 、 机 器 和 其 架构 的 部 分 和 不 依赖 的 部 分 。 这 种 能 力 极 大 
地 简化 了 板 文 持 包 的 创建 ， 允 许 它 们 仅仅 提供 依赖 于 硬件 的 必要 部 分 ， 并 补充 构建 系统 的 机 器 独立 部 分 。 因 此 ， 对 另外 机 器 构建 相同 的 Linux 发 行 版 是 如 
同 用 另 一 个 板 支 持 包 闪 换 板 支 持 包 一 样 简单 的 。 


这 个 架构 的 主要 部 分 由 机 器 配置 文件 组 成 ， 该 文件 包含 由 构建 需要 机 器 特定 适 配 的 软件 包 的 菜谱 引用 的 机 器 相关 性 的 变量 设置 。 机 器 配置 文件 是 以 
机 器 命名 的 ， 并 且 可 以 在 板 支 持 包 层 的 conf/machine 子 目录 中 找到 |。 


SK 


BitBake 荣 谱 形 成 构建 系统 的 核心 ， 因 为 它们 定义 针对 软件 包 的 工作 流 。 菜 谱 包 含 用 于 BitBake 的 关于 如 何 通过 实施 在 3.1 节 中 列 出 的 过 程 步骤 而 构建 
特定 软件 包 的 指令 。BitBake 菜 谱 以 它们 的 .bb 文件 扩展 名 标识 。 


菜谱 包含 简单 的 变量 复制 和 以 可 执行 元 数据 (executable metadata) 形式 仓 在 的 构建 指令 ， 构 建 指令 本 质 上 是 执行 过 程 步骤 的 钞 数 。 我 们 在 下 一 
章 讨论 BitBake 内 幕 时 会 解释 可 执行 元 数据 和 BitBake 任 务 的 细节 。 


与 配置 文件 相反 ， 所 有 在 菜谱 中 做 出 的 变量 赋值 都 是 仅 仪 本 地 于 茉 谱 的 。 虽 然 菜谱 通 单 引 用 在 配置 文件 中 做 出 的 变量 设置 并 且 有 时 为 了 它们 的 目的 
而 覆盖 变量 设置 ， 但 是 所 有 设置 都 是 保持 本 地 于 菜谱 的 。 


许多 软件 包 是 以 很 相似 的 方式 被 构建 出 来 的 ， 这 种 方式 使 用 遵循 相同 过 程 步骤 的 几乎 相同 的 构建 指令 。 在 调整 仅仅 一 些 特定 于 软件 包 的 部 分 时 重复 
性 地 复制 相同 的 菜谱 将 导致 大 量 多 余 的 努力 。 因 此 ，BitBake 提 供 了 类 的 概念 种 简单 的 允许 菜谱 可 以 容易 地 在 通用 工作 流 中 共享 的 继承 机 制 。 类 可 
以 被 任何 BitBake 层 所 定义 并 且 被 它们 的 .bbclass 文 件 扩展 所 识别 出 来 。 





另外 的 针对 菜谱 、 促 进 重 用 的 BitBake 机 制 是 妃 加 文件 (append files) 一 一 通过 它们 的 .bbappend 文 件 扩展 而 被 识别 出 来 。 追 加 文件 通 弟 由 构建 在 
其 他 层 之 上 的 层 根 据 针 对 它们 的 特殊 需求 来 优化 那些 层 中 包含 的 菜谱 。 在 大 部 分 情况 下 ， 它 们 会 履 蘑 变量 设置 或 者 修改 变量 设置 。 追 加 文件 拥有 和 从 其 
他 它们 正在 追加 的 层 来 的 核心 菜谱 相同 的 基础 文件 名 。 


3.2.2 ”工作 流 过 程 步骤 
由 OpenEmbedded 核 心 元 数据 层 确 立 和 由 BitBake 执 行 的 工作 流 本 质 上 遵循 在 3.1 节 中 列 出 的 步骤 。 
源 获 取 


菜谱 召集 源 (例如 源 文件 包 、 补 丁 和 辅助 文件 ) 的 位 置 。BitBake 可 以 从 构建 主机 本 地 或 远程 地 借助 网 络 从 外 部 源 仓库 获取 源 。 源 文件 可 以 以 大 量 不 
同 的 格式 呈现 ， 例 如 普通 或 者 压缩 的 tar 包 。 它 们 可 以 借 由 文件 传输 协议 而 被 获取 ， 也 可 以 从 例如 Git、SVN 等 的 源 控制 管理 (Source Control 
Management, SCM) 系统 获取 [1], 


菜谱 通过 在 变量 SRC_URI 中 包含 源 文件 的 统一 资源 标识 符 (Uniform Resource Identifier, URI) 来 指定 源 文件 的 位 置 。 在 SRC_URI 中 的 统一 资源 
标识 符 经 常 指向 软件 包 的 上 游 源 仓 库 ， 例 如 文件 下 载 服务 器 或 者 上 游 项 目的 源 控制 管理 系统 . 


在 尝试 从 由 菜谱 的 SRC_URI 变 量 指定 的 上 游 仓 库 中 下 载 源 软件 包 之 前 ，BitBake 先 检查 本 地 的 下 载 目 录 以 确认 正确 版 本 的 源 文 件 是 否 已 经 被 获取 下 


来 。 如 果 它 在 本 地 下 载 区 域 找 不 到 源 ， 那 么 BitBake 党 试 从 一 列 被 称 为 预先 镜像 (premirror) (如 果 它 们 被 配置 了 ) 的 镜像 文件 服务 器 上 获取 源 文件 。 
如 果 没 有 任何 预先 镜像 包含 必要 的 文件 ， 那 么 BitBake 尝 试 实际 的 、 由 SRC_URI 指 定 的 上 游 仓库 。 如 果 它 从 那里 找 不 到 文件 或 者 如 果 上 游 仓库 是 无 法 访问 
的 ， 那 么 BitBake 尝 试 从 第 2 个 列表 的 镜像 服务 器 下 载 文 件 。 在 本 书 的 上 下 文中 ， 我 们 称 这 些 服务 器 为 后 镜像 (postmirror) ,虽然 在 OpenEmbedded 
术语 中 ， 它 们 仅 仪 被 称 为 镜像 (mirrors) 。 


Yocto 项 目 维护 了 具有 局 可 用 性 的 文件 服务 器 ， 团 队 把 所 有 上 游 软 件 包 放 在 这 些 服务 器 上 。Poky 发 行 版 配置 命令 BitBake 在 尝试 直接 从 上 游 仓库 下 载 
文件 之 前 使 用 Yocto 项 目镜 像 。 使 用 Yocto 项 目镜 像 使 得 构建 更 少 地 依赖 上 游 文 件 服务 器 的 可 用 性 。 


你 也 可 以 通过 设置 作为 你 自己 构建 基础 设施 一 部 分 的 镜像 来 维护 你 构建 中 包含 的 源 的 直接 控制 。 
源 解 压 和 打 补 本 


一 旦 源 被 下 载 到 本 地 的 下 载 目录 ， 它 们 将 被 解压 进 本 地 构建 环境 中 。 如 果 任 何 补丁 被 指定 成 源 下 载 的 一 部 分 ， 那 么 使 用 Quilt 来 应 用 它们 。 


通常 ， 源 包 是 不 适合 于 交叉 构建 的 ， 因 此 大 部 分 补丁 都 是 集成 补丁 ， 修 改 了 使 用 BitBake 进 行 正 确 构 建 的 源 代码 。 
配置 、 编 译 和 安 妆 


通过 它 的 类 ，OpenEmbedded 提 供 了 各 种 模式 来 构建 标准 软件 包 ， 例 如 基于 Make 的 包 、 基 于 GNU Autotools 的 包 和 基于 CMake 的 包 。 这 些 模式 
提供 了 标准 化 的 方法 来 指定 定制 化 的 环境 设置 。 在 第 8 章 中 ， 我 们 将 探索 用 BitBake 通 过 标准 模式 构建 包 以 及 定制 化 它们 的 细节 。 


虽然 配置 、 编 译 和 安装 是 构建 过 程 中 不 同 的 步骤 ， 但 它们 通常 是 在 相同 的 类 中 被 解决 的 ， 因 为 它们 都 包含 调用 包 自 己 构建 系统 的 部 分 。 


安装 步骤 是 使 用 pseudol 人 命令 来 执行 的 ， 它 允许 特殊 文件 的 创建 和 被 正确 设置 的 属 主 、 属 组 以 及 其 他 等 权限 。 所 有 文件 是 被 安装 进 私 有 的 、 存 在 于 
针对 特定 包 的 构建 环境 中 的 系统 根 目录 中 。 


输出 分 析 和 打包 


在 输出 分 析 中 ， 由 前 一 个 步骤 生成 和 安 濠 的 软件 按照 它 的 功能 被 分 类 成 : 运行 时 文件 、 调 试 文件 、 开 友 文 件 、 文 档 和 语言 环境 。 这 允许 文件 为 包 管 
理 系统 而 被 拆 分 进 多 个 物理 包 中 。 


在 分 析 之 后 ， 包 通过 使 用 一 个 或 者 多 个 常见 的 打包 格式 RPM、dpkg 和 ipkgm 而 被 创建 。 


BitBake 为 在 构建 环境 配置 文件 local.conf 的 PACKAGE_CLASSES 变 量 中 包含 的 包 管理 系统 类 创建 包 。 昌 然 BitBake 可 以 为 一 个 或 者 多 个 类 创建 包 ， 
但 是 它 只 使 用 第 一 个 列 出 的 类 来 为 友 行 版 创建 最 终 的 根 文件 系统 。 


镜像 创建 


针对 发 行 版 的 根 文件 系统 的 各 种 镜像 是 使 用 来 自打 包 步 又 的 包 仓 库 创建 的 。 使 用 包 管 理 系统 将 包 从 包 仓 库 安 沪 进 根 文 件 系统 试 运行 区 域 。 


哪些 包 被 安 委 进 镜像 ， 是 由 集合 了 针对 基于 定义 的 需求 集 的 工作 系统 的 功能 集 的 镜像 菜谱 决定 的 。 例 如 ， 最 小 镜像 可 能 包含 仅仅 足够 局 动 审 有 最 少 
基础 应 用 集合 的 命令 行 操 作 的 包 ， 而 市 有 图 形 用 户 界 面 的 镜像 可 能 包含 X 服 务 器 和 许多 其 他 应 用 包 . 


镜像 创建 是 由 core-image 类 处 理 的 ， 其 中 ， 它 评估 变量 IMAGE INSTALL 来 判断 要 包含 在 镜像 中 的 包 的 列表 。 


镜像 可 以 以 多 种 格式 被 创建 ， 包 括 用 于 解压 在 格式 化 的 文件 系统 中 的 tar.bz2， 以 及 其 他 格式 ， 例 如 ext2、ext3、ext4 和 jffs， 它 们 可 以 被 直接 比特 复 
制 到 合适 的 存储 设备 。 


软件 开发 工具 包 生成 


作为 格外 的 步骤 ， 它 不 是 标准 构建 过 程 的 一 部 分 ， 市 着 创建 可 局 动 操作 系统 枝 的 目的 ， 软 件 开 友 工 具 包 (Software Development Kit, SDK) 可 以 
REE, 


软件 开发 工具 包 包含 了 针对 开发 主机 的 原生 应 用 ， 例 如 交叉 工具 链 、QEMU 模 拟 器 和 安装 脚本 。 它 可 能 也 包含 和 模拟 器 一 起 使 用 的 、 基 于 镜像 创建 
步骤 内 容 的 根 文 件 系统 镜像 。 软 件 开 上 友 工 具 包 可 以 被 应 用 开发 者 用 来 创建 和 测试 应 用 程序 ， 其 使 用 与 构建 目标 系统 时 相同 的 环境 ， 而 没有 实际 使 用 
OpenEmbedded 构 建 系统 。 


软件 开 友 工具 包 和 它 的 工具 可 能 从 命令 行 直接 应 用 在 开发 主机 上 ， 并 且 是 通过 与 Eclipse 和 集成 开发 环境 集成 而 被 使 用 。 对 于 后 者 来 涡 ，Yocto 项 目 提 


供 了 用 于 Eclipse 的 、 可 以 直接 被 从 Eclipse 工 作 台 安 六 的 插件 。 


[1] 完整 的 协议 和 源 控制 管理 包括 HTTP、FTP、HTTIPS、Git、Subvetrsion (SVN) 、Perforce (P4) ~ Mercurial SCM (Hg) ~ Bazar (BZR) . CVS. Open 
Build Service (OSC) 、REPO、SSH 和 SVK。 


[2] http://www.yoctoproject.org/ tools-resources/projects/pseudo。 


3.3 OpenEmbedded 构 建 系统 架构 


3 个 基础 组 件 组 成 了 OpenEmbedded 构 建 系 统 架构 : 
` 构建 系统 

. 构建 环境 

. 元 数据 层 


图 3-2 搬 绘 了 组 件 及 其 相互 关系 。 


商业 的 


应 用 开发 构建 安装 程序 
软件 开发 工具 
构建 输出 


TSE 构建 环境 





创建 /初始 化 


OpenEmbedded 核 心 Yocto 项 目 板 文 持 包 Yocto 项 目 发 行 版 
(meta) (meta-yocto-bsp) (meta-yocto) 


基础 元 数据 层 


OpenEmbedded 构 建 系 统 





图 3-2 Poky 3874 


除了 少量 随 任何 Linux 发 行 版 而 来 的 额外 软件 包 以 外 ，OpenEmbedded 构 建 系统 为 构建 谨 入 式 Linux 操 作 系统 栈 提供 了 所 有 必要 组 件 。 包 含 在 内 的 
Æ: BitBake 构 建 3 引擎 ; 一 套 为 便利 性 而 提供 额外 功能 性 的 集成 脚本 ; 各 种 工具 ; OpenEmbedded 核 心 一 一 BitBake 所 需要 的 用 以 构建 镜像 的 核心 元 数 
据 集 合 ; DocBook 格 式 的 完整 的 文档 。Poky 参 考 友 行 版 也 包括 了 最 小 集合 的 基础 元 数据 层 : Yocto 项 目 板 支持 包 (meta-yocto-bsp) 和 Yocto 项 目 友 行 
版 (meta-yocto) 。 





正如 我 们 在 第 2 章 中 所 看 到 的 ， 脚 本 oe-init-build-env 创 建 并 初始 化 构建 环境 。 这 个 脚本 是 包含 在 构建 系统 内 的 脚本 之 一 。 构 建 系统 和 构建 环境 形成 


1: n 的 关系 : 构建 系统 可 以 和 任何 数量 的 构建 环境 相关 联 ， 但 是 构建 环境 仪 仅 可 以 和 构建 系统 相 天 联 。 在 你 一 次 使 用 多 于 一 个 Yocto 项 目 友 布 时 ， 这 是 
重要 的 、 你 需要 知道 的 限制 。 你 仅仅 可 以 用 构建 环境 和 它 原 来 被 创建 时 用 到 的 版 本 的 构建 系统 。 使 用 不 同 于 原来 被 用 来 创建 这 个 构建 环境 的 构建 系统 来 
切 始 化 构建 环境 会 导致 构建 失败 。 


构建 系统 总 是 要 包含 元 数据 层 ， 它 提供 菜谱 和 配置 文件 。 当 你 用 构建 系统 的 oe-init-build-env 脚 本 创建 构建 环境 的 时 候 ， 脚 本 自动 设置 包含 了 3 个 基 
础 层 的 conf/bblayers.conf 文 件 : meta、meta-yocto-bsp 和 meta-yocto。 这 些 基础 层 足够 来 构建 标准 的 Poky 参 考 发 行 版 。 然 而 ， 作 为 秦 入 式 Linux 开 
发 者 ， 你 最 终 希 望 创建 你 自己 的 太行 版 、 增 加 你 自己 的 软件 包 并 最 终 为 目标 硬件 提供 你 自己 的 板 支 持 包 。 这 个 目标 是 通过 包含 构建 系统 的 其 他 元 数据 层 
来 实现 的 。 


在 接 下 来 的 部 分 ， 我 们 将 更 加 细节 地 探索 构建 系统 的 结构 、 构 建 环 境 和 元 数据 层 。 


3.3.2 ”构建 环境 结构 


OpenEmbedded 构 建 系统 在 构建 环境 内 执行 它 的 全 部 工作 。 构 建 环 境 也 有 特定 的 布局 和 结构 。 布 局 以 及 其 中 的 所 有 目录 和 文件 是 由 构建 系统 目 动 化 
地 创建 的 。 构 建 环境 的 目录 和 文件 结构 是 深度 嵌 套 的 。 程 序 清单 3-2 显 示 了 在 构建 已 经 运行 后 的 前 2 级 结构 。 


程序 清单 3-2 构建 环境 结构 


yocto@yocto-dev:~/yoctos tree -L 2 build 


x86/ 
-— bitbake.lock 
-— cache 


| | 一 bb_codeparser.dat 

| | 一 bb_persist_data.sqlite3 

| L— local file checksum_cache.dat 
-— conf 

| | 一 bblayers.conf 

| | 一 local.conf 

| [一 sanity_info 


| 一 abi_version 

-— buildstats 

| 一 cache 

-— deploy 

| — images 

| —-— licenses 

| -— deb 

| = ipk 

| L— rpm 

P= og 

| 一 qa.log 

-—  saved_tmpdir 

| 一 sstate-control 

-— stamps 

-— sysroots 

-— work 

| -—  all-poky-linux 
| -— 1586-poky-linux 
| | 一 qemux86-poky-linux 
| L— x86_64-linux 
L— work-shared 


新 创建 的 构建 环境 仅仅 包含 conf 子 目录 和 2 个 文件 : bblayers.conf 和 local.conf。 在 第 2 章 中 设置 和 配置 我 们 的 第 一 个 构建 环境 时 ， 我 们 遇 到 过 后 者 
(此 处 指 文件 local.conf) 。 这 个 文件 包含 用 于 构建 环境 的 所 有 配置 设置 。 你 也 可 以 向 其 增加 本 地 履 盖 来 自 被 包含 层 中 的 设置 的 变量 设置 。 
文件 bblayers.conf 包 含 用 于 构建 环境 的 层 设 置 。 列 表 3-3 显 示 了 一 个 典型 的 bblayers.conf 文 件 。 


程序 清单 3-3 bblayers.conf 


# LCONF_VERSION: version number for bblayers.conf 


# It is increased each time build/conf/bblayers.conf 
# changes incompatibly 
LCONF_VERSION = "6" 


BBPATH = "S${TOPDIR}" 
BBFILES ?= "" 
BBLAYERS ?= " \ 


/absolute/path/to/poky/meta \ 
/absolute/path/to/poky/meta-yocto \ 
/absolute/path/to//poky/meta-yocto-bsp \ 


BBLAYERS NON _REMOVABLE ?= " \ 
/absolute/path/to/poky/meta \ 
/absolute/path/to/poky/meta-yocto \ 


在 这 个 文件 中 最 重要 的 变量 是 BBLAYERS， 它 是 空格 分 隅 的 、 到 所 有 该 构建 环境 包含 的 层 的 路 径 列 表 。 这 是 你 可 以 增加 在 构建 环境 中 入 包含 的 额外 
层 的 地 方 。 这 个 文件 也 设置 BBPATH 成 构建 环境 的 顶级 目录 ， 并 且 用 空 字 符 串 来 初始 化 荣 谱 文件 列表 BBFILEs。 


其 他 目录 和 文件 是 在 构建 过 程 中 被 创建 的 。 所 有 的 构建 输出 被 放 进 tmp 子 目录 。 你 可 以 通过 设置 在 环境 的 conf/local.conf 文 件 中 的 TMPDIR 变 量 来 
配置 这 个 目录 。 在 tmp 目 录 中 的 构建 输出 被 组 织 进 大 量子 目录 中 : 


- buildstats: 这 个 子 目 录 存 储 根据 构建 目标 和 目标 被 构建 时 的 日 期 /时 间 戳 组 织 的 构建 统计 。 


-cache: 当 BitBake 初 步 解析 元 数据 时 ， 它 分 析 依 赖 性 和 表达 式 。 解 析 过 程 的 结果 被 写 入 缓存 。 只 要 元 数据 没有 改变 ，BitBake 在 后 续 运行 时 直接 从 


这 个 缓存 获取 元 数据 信息 。 
. deploy: 针对 部 署 的 构建 输出 ， 例 如 目标 文件 系统 镜像 、 包 仓库 和 许可 信息 ， 被 包含 在 deploy 子 目录 中 。 
. log: 你 可 以 在 此 找到 由 cooket 进 程 创建 的 BitBake 日 志 信 息 。 
- sstate-control: 这 个 子 目 录 包 含 用 于 根据 架构 /目标 和 任务 组 织 的 共享 状态 缓存 的 程序 清单 文件 。 
- Stamps: BitBake 把 针对 每 个 任务 、 根 据 架 构 /目标 组 织 的 完成 标签 和 签名 数据 以 及 包 名 放 在 这 个 子 目录 中 。 


-sysroots: 这 个 子 目 录 包 含 根 据 架 构 / 目 标 组 织 的 根 文 件 系 统 。 内 容 包 括 针 对 构建 主机 的 ， 包 含 交 又 工具 链 、QEMU 和 在 构建 过 程 中 用 到 的 很 多 工 


具 的 根 文件 系统 。 
-work: 在 这 个 目录 中 ，BitBake 创 建 根 据 架 构 / 目 标 组 织 的 、 它 在 这 里 构建 实际 软件 包 的 子 目 录 。 
- work-shared: 这 个 子 目 录 和 wotk 类 似 ,， 但 是 针对 共享 的 软件 包 。 


也 有 2 个 在 tmp 目 录 中 值得 解释 的 文件 : abi_version 和 saved_tmpdir。 前 者 包含 针对 tmp 目 录 布 局 的 版 本 号 码 。 当 布局 变化 时 ， 这 个 号 码 增加 。 这 
个 号 码 允 许 验 证 构建 环境 是 否 和 构建 系统 是 兼容 的 。 后 者 包含 imp 目录 的 绝对 文件 系统 路 径 。 很 多 在 tmp 目 录 下 的 文件 包含 绝对 文件 路 径 。 很 不 幸 ， 这 
种 安排 使 得 目录 不 可 迁移 。 虽 然 这 种 限制 可 能 不 够 方便 ， 但 是 saved_tmpdir 文 件 使 得 你 可 以 方便 地 检查 目录 是 否 已 经 被 从 原始 位 置 移出 来 了 。 


尽管 构建 环境 ， 特 别 是 通常 位 于 其 中 的 tmp 目 录 ， 不 可 以 被 简单 地 迁移 ， 但 是 BitBake 本 质 上 可 以 从 共享 状态 缓存 重新 创建 tmp 目 录 的 所 有 内 容 。 共 
享 状态 缓存 存储 上 自 其 输入 元 数据 (例如 任务 代码 、 变 量 等 ) 创建 的 签名 所 识别 的 任务 的 中 间 输 出 。 只 要 输入 不 变 ， 那 么 签名 束 不 变 ， 使 得 BitBake 使 用 来 
目 共 享 状态 缓存 的 输出 而 不 是 运行 任务 。 这 极 大 地 缩短 了 构建 时 间 ， 特 别 是 针对 那些 花费 长 时 间 运 行 的 任务 ， 例 如 配置 或 者 编译 。 


3.3.3 ”元 数据 层 结 构 


元 数据 层 是 分 组 和 组 织 菜 谱 、 类 、 配 置 文 件 和 其 他 元 数据 到 多 辑 实体 中 的 容器 。 层 通常 构建 在 其 他 层 之 上 并 且 彼 此 互相 扩展 。OpenEmbedded 核 心 
层 形成 了 针对 Poky 构 建 系统 的 层 染 构 的 基础 。 它 提供 了 针对 大 部 分 Linux 操 作 系 统 栈 需要 的 软件 包 的 核心 集合 的 菜谱 ， 当 然 包 括 Linux 内 核 、 引 导 加 载 程 


序 、 图 形 、 网 络 和 许多 其 他 包 。OpenEmbedded 核 心 也 提供 基础 类 以 构建 软件 包 、 用 包 管 理 系统 打包 软件 、 创 建文 件 系 统 和 扩展 BitBake 功 能 性 。 


OpenEmbedded 核 心 层 本 身 ， 由 BitBake、 便 利 性 和 和 集成 脚本 所 补充 ， 针 对 构建 用 于 模拟 的 设备 的 Linux 操 作 系 统 栈 来 说 是 足够 的 。 
OpenEmbedded 核 心包 含 基础 镜像 目标 和 针对 用 于 ARM、MIPS、PowerPC、x86 和 x86_64 架 构 的 QEMU 模 拟 器 的 机 器 定义 。 


针对 设备 操作 系统 栈 的 构建 环境 通常 包含 其 他 层 ， 例 如 用 于 实际 硬件 的 板 支 持 包 层 ; 指定 用 于 用 尸 账号 、 系 统 局 动 等 操作 系统 配置 的 友 行 版 屋 ， 用 
户 界 面 层 和 用 于 用 户 空间 应 用 、 提 供 设备 功能 性 的 应 用 层 。 图 3-3 摘 述 了 以 构 。 





层 布 局 
所 有 层 ， 不 管 它们 服务 的 目的 是 什么 ， 都 有 如 程序 清单 3-4 所 示 的 相同 的 基本 结构 (目录 名 字 是 斜体 化 的 以 把 它们 和 文件 名 区 分 开 ) 。 


程序 清单 3-4 Bie 


meta-<layername> 
—-— conf 
—-— layer.conf 
-— machine 
| -— <machine 1>.conf 
| 一 <machine 2>.conf 


| 

| | 一 ... 

| L— <machine m>.conf 
—-— distro 


| 

| 

| 

| 

| 

| 

| 

| | | 一 <distro 1>.conf 
| | — <distro 2>.conf 
| | a ow tea 

| | L— <distro r>.conf 
— classes 

| |- class<1>.bbclass 


| -~ class<2>.bbclass 
| — ... 

| L— class<l>.bbclass 
| 一 recipes-<category 1> 
| |- <package a> 

| | | 一 <package a>_<version 1>.bb 
| | L— <package a>_<version 2>.bb 
| k- <package b> 

| | | 一 <package b>_<version 1>.bb 
| | [一 <package b>_<version 2>.bb 
| 

| 


lL <package z> 
| 一 recipes-<category 2> 
| Le, 


L— recipes-<category n> 
L 


元 数据 层 本 质 上 是 由 目录 和 文件 组 成 的 结构 。 层 顶级 目录 的 名 字 并 不 严格 ; 但是， 按照 惯例 ， 所 有 的 层 目 录 名 字 以 词 meta 开 涉 、 接 下 来 是 连 字符 
(-) 和 层 的 名 字 。 


每 个 层 必须 包含 含有 该 层 配置 文件 layer.conf 的 conf 子 目录 。BitBake 需 要 这 个 文件 来 设置 针对 元 数据 文件 的 路 径 和 搜索 模式 。 程 序 清单 3-5 显 示 了 
样本 的 layer.conf 文 件 。 


程序 清单 3-5 layer.conf 


# Add the layer's directory to BBPATH 
BBPATH =. "S{LAYERDIR}:" 


# Add the layer's recipe files to BBFILES 
BBFILES += "S{LAYERDIR}/recipes-*/*/*.bb \ 
S$ {LAYERDIR}/recipes-*/*/* .bbappend" 


# Add the name of the layer to the layer collections 
BBFILE COLLECTIONS += "layername" 


# Set the recipe file search pattern 
BBFILE_PATTERN_layername = "“*S${LAYERDIR}/" 


# Set the priority of this layer 
BBFILE PRIORITY _layername = "5" 


# Set version of this layer 

# (should only be incremented if changes break compatibility) 
LAYERVERSION_layername = "2" 

# Specify other layers this layer depends on. This is a white space- 

# delimited list of layer names. If this layer depends on a particular 
# version of another layer, it can be specified by adding the version 
# with a colon to the layer name: e.g., anotherlayer:3. 
LAYERDEPENDS_layername = "core" 


第 一 个 赋值 向 BBPATH 变 量 增加 层 的 目录 。 变 量 LAYERDIR 被 BitBake 扩 展 成 层 的 权威 路 径 名 字 。 然 后 ， 层 的 菜谱 被 增加 到 BBFILES 变 量 。 你 可 以 看 
到 ， 通 配 符 表达 式 匹 配 在 这 层 的 菜谱 目录 的 布局 。 用 于 菜谱 和 菜谱 追加 文件 的 通配符 都 需要 被 增加 到 BBFILES。 


BBFILE COLLECTIONS 是 由 空格 分 隔 的 层 名 字 的 列表 。 每 一 层 向 列表 增加 它 的 名 字 。BBFILE_PATTERN 包 含 正则 表达 式 来 匹配 在 BBFILES 变 量 中 的 
这 一 层 的 菜谱 。 这 个 变量 是 以 层 为 条 件 的 ， 因 此 变量 名 需要 以 层 的 名 字 作 为 前 绎 [1]。 


因为 层 互 相依 赖 和 扩展 ， 所 以 处 理 顺 序 是 重要 的 。 因 此 ， 每 层 通过 设置 BBFILE PRIORITY 来 赋予 优先 级 。 层 优先 级 处 于 1 到 10 之 间 ，1 是 最 低 优 先 
级 、10 是 最 高 优先 级 。 如 果 2 个 层 使 用 相同 的 优先 级 ， 那 么 它们 在 文件 bblayers.conf 中 的 变量 BBLAYERS 的 顺序 决定 优先 级 。 


可 选 的 是 ， 层 也 可 以 通过 设置 变量 LAYERVERSION 来 定义 版 本 号 。 层 版 本 可 以 和 LAYERDEPENDS 变 量 一 起 使 用 以 避免 包含 层 的 不 兼容 版 本 。 如 果 
层 依赖 于 另外 的 层 ， 那 么 这 些 依赖 性 可 以 通过 增加 这 些 层 到 LAYERDEPENDS 变 量 来 设置 ，LAYERDEPENDS 包 含 了 空格 分 隔 的 层 名 字 的 列表 。 如 果 依 赖 


性 是 基于 层 的 特定 版 本 ， 那 么 版 本 号 可 以 通过 增加 冒号 (: ) 和 版 本 号 来 指定 。 


子 目录 conf 可 能 包含 其 他 文件 和 目录 ， 特 别 是 distro 和 machine 子 目录 。 这 些 是 可 选 的 。 典 型 的 是 ， 仅 仅 发 行 版 层 将 包含 distro 子 目录 ， 并 且 仅仅 板 
支持 包 层 通常 包含 machine 子 目录 。 如 果 存 在 ， 那 么 这 2 个 子 目录 的 每 一 个 都 包含 用 于 发 行 版 和 机 器 配置 的 文件 吕 。 


如 果 层 定义 自己 的 类 ， 那 么 它们 位 于 classes 子 目录 中 。 


层 的 菜谱 由 类 别 和 包 分 组 。 类 别 是 一 组 逻辑 上 属于 一 起 的 包 。 例 如 ，OpenEmbedded 核 心 元 数据 层 的 recipes-connectivity 类 别 包含 构建 用 于 网 
络 、 电 话 和 其 他 连接 功能 软件 的 包 的 菜谱 。 在 每 个 类 别 子 目录 中 ， 有 针对 不 同 软 件 包 的 子 目录 。 这 些 包 子 目 录 包 含 菜谱 、 补 丁 和 其 他 构建 软件 包 所 需要 
的 文件 。 通 常 ， 包 子 目录 包含 用 于 构建 不 同 版 本 的 特定 包 的 菜谱 。 


创建 层 


使 用 针对 板 支持 包 、 应 用 软件 、 发 行 版 策略 等 的 层 对 你 自己 的 项 目 产生 了 很 多 好 处 。 大 部 分 项 目 从 小 处 开始 ， 但 随后 越 来 越 多 的 功能 性 被 增加 。 即 
使 你 一 开始 仅仅 有 1 个 或 者 2 个 菜谱 ， 把 菜谱 放 在 你 自己 的 层 而 不 是 增加 它们 进 OpenEmbedded 核 心 层 或 者 任何 Yocto 项 目 层 依然 是 好 的 实践 


你 自己 的 层 从 常用 菜谱 中 分 离 你 自己 的 菜谱 ， 使 得 对 你 来 说 容易 从 OpenEmbedded 构 建 系 统 的 一 个 版 本 迁移 到 下 一 个 。 你 仅仅 需要 用 新 的 构建 系统 
创建 新 的 构建 环境 ， 并 且 在 这 个 构建 环境 中 包含 进 层 。 


通过 在 层 中 使 用 bbappend 文 件 ， 你 可 以 从 常用 层 中 调整 菜谱 而 不 是 复制 或 者 重 写 它们 。 考 虑 下 在 meta/recipes-kernel/linux 中 用 于 构建 Linux 内 核 
的 菜谱 。 就 绝 大 部 分 而 言 ， 它 们 已 经 提供 了 用 于 构建 内 核 的 所 有 必要 的 东西 。 对 你 自己 的 板 支 持 包 层 ， 你 通常 需要 仪 仪 改进 几 个 设置 来 完全 支持 目标 硬 
件 。 不 必 复 制 内 核 菜谱 ， 你 可 以 使 用 bbappend 文 件 或 者 包含 文件 来 按照 需求 定制 基础 菜谱 。 


用 yocto-layer 脚 本 创建 层 是 简单 和 直接 的 。 在 引用 了 构建 环境 后 ， 这 个 脚本 在 命令 行 搜索 路 径 下 是 直接 可 用 的 。 简 单调 用 这 个 脚本 如 下 : 
S yocto-layer create <layername> 


如 果 你 想 创建 样 例 菜谱 或 样 例 bbappend 文 件 ， 那 么 脚本 提示 你 输入 新 层 的 优先 级 ， 然 后 在 当前 目录 中 创建 包含 conf/layer.conf 文 件 和 样 例文 件 的 
层 。 所 有 你 需要 做 的 是 ， 向 你 构建 环境 的 conf/bblayers.conf 文 件 中 的 BBLAYERS 变 量 增 加 层 以 在 构建 过 程 中 包含 它 。 当 然 ， 你 也 需要 根据 你 项 目 需 求 而 
修改 样 例 菜谱 或 新 菜谱 、 配 置 文件 和 类 。 


1] 我 们 将 在 第 4 章 讨 论 条 件 变 量 设置 。 


D] 我 们 将 在 接 下 来 的 章 中 解释 发 行 版 层 和 板 支 持 包 层 。 


34 总 结 


IONA 


本 章 展示 了 构建 系统 及 其 工作 沅 和 其 组 件 的 概览 。 

` 开源 软件 包 最 常见 的 是 遵循 标准 工作 流 构建 的 。 

- OpenEmbeddedq 构 建 系统 为 数 百 个 从 源 代码 构建 出 来 的 包 自 动 化 工作 流 步 骤 以 创建 具有 完整 功能 性 的 Linux 操 作 系 统 栈 。 
- BitBake 不 仅 构 建 软件 包 而 且 也 打包 可 以 被 通用 包 管理 系统 dpkg、RPM 和 ipkg 所 利用 的 可 执行 文件 、 库 、 文 档 等 进 包 中 。 
- 构建 系统 创建 可 以 被 安装 在 目标 系统 上 的 根 文件 系统 镜像 。 

- 可 选 的 是 ，BitBake 可 以 为 开发 者 构建 包含 交叉 开发 工具 的 软件 开发 工具 包 以 构建 针对 目标 系统 的 应 用 。 


+ 组 成 架构 的 3 个 核心 组 件 是 OpenEmbedded 构 建 系 统 、 构 建 环境 和 元 数据 层 。 





* Poky 参 考 发 行 版 包含 OpenEmbedded 构 建 系统 和 这 3 个 元 数据 层 
(meta-yocto-bsp) ， 这 3 个 元 数据 层 在 构建 环境 被 创建 的 时 候 自 动 化 地 加 到 了 构建 环境 中 。 


OpenEmbedded 核 心 (meta) 、Yocto 发 行 版 (meta-yocto) 和 Yocto 板 支持 包 


J 


分 组 元 数据 进 逻 辑 实 体 ， 例 如 板 支 持 包 、 发 行 版 层 和 应 用 层 等 。 


3.5 ”参考 文献 


Yocto 项 目 文 档 ,，https://www.yoctoproject.org/documentation/current。 
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第 4 草 ”BitBake 构 建 5 


BitBake 是 类 似 Make 和 Apache Ant 的 构建 工具 。 然 而 ， 因 为 它 灵活 且 可 扩展 的 架构 ，BitBake 的 能 力 远 远 超过 典型 软件 构建 引擎 所 提供 的 东西 。 
BitBake 的 元 数据 语法 不 仅 文 持 变量 和 简单 命令 的 执行 ， 而 且 可 以 庶 入 整个 shell 脚 本 和 Python 冰 数 。 


BitBake 源 于 Portage 一 一 Gentoo Linux 皮 行 版 所 使 用 的 构建 和 包 管 理 系 统 。BitBake 是 完全 用 Python 编写 的 ， 这 使 它 在 大 部 分 情况 下 是 平台 独立 的 
一 一 只 要 平台 提供 Python 运行 时 环境 。 


与 任何 软件 构建 工具 一 样 ，BitBake 自 己 不 提供 用 以 构建 软件 包 的 功能 性 。 它 必须 由 包含 在 元 数据 文件 中 的 构建 指令 来 补充 。BitBake 元 数据 文件 类 
似 Make 的 makefiles 和 Ant 的 build.xml 文 件 。OpenEmbedded 和 Yocto 项 目 提 供 必要 的 元 数据 以 构建 数 干 个 软件 包 并 且 将 它们 集成 进 包 含 完整 功能 的 
Linux 操 作 系 统 栈 的 文件 系统 镜像 中 。 


4.1 锋 取 和 和 安装 BitBake 


BitBake 是 OpenEmbedded 构 建 系 统 的 核心 组 件 ， 在 前 面 的 章节 中 已 有 摘 述 。BitBake 是 Yocto 和 OpenEmbedded 共 同 维护 的 Yocto 项 目的 子 项 
目 。BitBake 源 仓库 原来 是 托管 在 http://developer.berlios.de/projects/bitbake， 但 是 在 Yocto 项 目 创建 后 ,活跃 的 开发 分 支 被 移动 到 位 
于 http://git.openembedded.org/bitbake 的 OpenEmbedded 的 Git 仓 库 。 


你 从 Yocto 项 目 网 站 下 载 的 或 者 从 Yocto 项 目的 Git 仓 库 克 隆 出 来 的 构建 系统 总 是 包含 匹配 Poky 元 数据 的 BitBake 版 本 。 因 此 ， 在 使 用 Poky 时 ， 你 不 
必要 担心 下 载 和 安装 BitBakel1]。 然 而 ， 如 果 你 有 兴趣 使 用 BitBake 用 于 其 他 项 目 ， 例 如 追踪 当前 BitBake 开 发 状态 ， 或 者 期 待 向 BitBake 作 贡献 ， 那 么 你 
可 以 从 OpenEmbedded 仓 库 下 载 它 并 且 在 系统 上 安装 它 。 


我 们 举例 说 明 BitBake 的 下 载 和 安 沪 以便 你 可 以 看 到 BitBake 如 何 工 作 。 使 用 BitBake 进 行 实验 并 且 学 习 它 的 内 部 工作 机 制 而 不 用 OpenEmbedded 构 
建 系统 目 市 的 集成 是 一 个 有 用 的 设置 。 


[1] 不 鼓励 使 用 非 构 建 系统 附带 的 BitBake 版 本 。BitBake 是 和 提供 它 的 构建 系统 紧 窗 集成 的 。 


4.1.1 ”使 用 友 布 快照 
已 发 布 BitBake 版 本 的 压缩 tar 包 可 以 通过 浏览 器 从 OpenEmbedded 的 Git 仓 库 下 载 或 者 使 用 wget 命 令 : 
wget https://git.openembedded.org/bitbake/snapshot/bitbake-1.17.0.tar.bz2 
执行 
tar xvjf bitbake-1.17.0.tar.bz2 -C ~ 


解压 包 到 home 目 录 中 ， 创 建 和 名字 为 bitbake-1.17.0 且 包含 了 BitBake 源 的 子 目录 。 


41.2 FalzBitBakeH#RBEEE 
如 下 命令 
git clone git://git.openembedded.org/bitbake.git ~/bitbake 


克隆 BitBake 的 Git 仓 库 进 home 目 录 的 bitbake 目 录 中 ， 并 上 且 检 出 主干 (master) 分 支 。 和 Git 仓 库 一 样 ， 主 干 分 支 是 实际 的 开发 分 支 。 


4.1.3 ”构建 和 安装 BitBake 


BitBake 源 树 包含 让 你 可 以 预先 编译 BitBake 的 Python 源 模块 、 创 建文 档 并 且 最 终 在 系统 上 安 六 BitBake 的 setup.py 脚 本 。 
从 你 已 经 解压 或 者 克隆 BitBake 源 的 目录 中 ， 执 行 


./setup.py build 


以 编译 BitBake 并 从 DocBook 源 中 创建 HTML 和 PDF 格式 的 文档 。 编 译 BitBake 要 求 Python Lex-Yacc (PLY) @ARSCREARE. JAA Linuxz 
行 版 都 提供 这 个 包 。 执 行 


./setup.py install 


= BitBakefl CHF RARLAZL Python k HRP, HARB LinuxA{TiRE, te/usr/lib/python<version>/site-packages, 23% 
BitBake 当 然 是 可 选 的 ， 因 为 你 可 以 直接 从 它 的 源 目录 中 使 用 BitBake。 


42 运行 BitBake 
如 果 你 已 经 用 过 Make， 那 么 你 知道 ， 你 可 以 执行 它 而 不 带 任何 参数 ，Make 在 当前 目录 中 寻找 被 称 为 GNUmakefile、makefile 或 者 Makefile 的 文 


件 ， 并 且 构 建 它 在 文件 中 找到 的 默认 目标 。Ant 是 相当 类 似 的 ， 因 为 它 在 当前 目录 中 搜索 名 字 为 build.xm| 的 文件 。 这 两 个 工具 也 让 你 可 以 显 式 地 指定 包 
含 构建 指令 的 文件 作为 命令 行 参 数 。 


BitBake 本 质 上 以 相同 的 方式 工作 。 然 而 ，BitBake 总 是 必须 要 用 菜谱 的 基 名 称 (base name) 或 者 目标 作为 参数 而 被 调用 : 


9 bitbake core-image-minimal 


在 这 个 例子 中 ，core-image-minimal 对 应 于 菜谱 core-image-minimal.bb。 然 而 ,与 Make 和 Ant 不 同 ，BitBake 不 自动 在 当前 目录 中 寻找 菜谱 。 
BitBake 要 求 你 在 它 可 以 定位 和 执行 构建 指令 前 设置 执行 环境 。 


4.2.1 BitBake 执 行 环境 


在 启动 时 ，BitBake 首 先 在 当前 工作 目录 中 寻找 conf/bblayers.conf 配 置 文件 〈( 见 程序 清单 4-1) 。 


程序 清单 4-1 conf/bblayers.conf 


BBPATH = "S${TOPDIR}" 
BBFILES ?= "" 


BBLAYERS ?= " \ 
/path/to/directory/for/layerl \ 
/path/to/directory/for/layer2 \ 
/path/to/directory/for/layer3 \ 


" 


虽然 这 个 文件 是 可 选 的， 但 是 它 出 现在 任何 使 用 层 架 构 的 BitBake 构 建 环 境 中 ， 它 包括 所 有 由 Yocto 项 目 工 具 创建 的 构建 环境 。BitBake 期 望 这 个 文 
件 包含 被 称 为 BBLAYERS 的 变量 ，BBLAYERS 包 含 指向 目录 的 路 径 列 表 ， 包 含 在 构建 环境 中 的 层 可 以 在 那里 被 找到 。 这 些 层 目 录 中 的 每 一 个 都 被 期 望 包含 
名 为 conf/layer.conf 的 文件 ( 见 程序 清单 4-2) 。 


程序 清单 4-2 conf/layer.conf 


# We have a conf and classes directory, add to BBPATH 
BBPATH .= ":S{LAYERDIR}" 


# We have recipes-* directories, add to BBFILES 
BBFILES += "S${LAYERDIR}/recipes-*/*/*.bb \ 

$ {LAYERDIR}/recipes-*/*/* .bbappend" 
BBFILE COLLECTIONS += "layerl1" 


BBFILE_PATTERN_layerl = "*“${LAYERDIR}/" 
BBFILE_PRIORITY_layerl = "6" 


层 配 置 文件 conf/layer.conf 的 目的 是 正确 设置 变量 BBPATH 和 BBFILES 以 使 得 BitBake 可 以 找到 在 该 层 中 包含 的 菜谱 、 类 和 配置 文件 : 


- BBPATH: BitBake 使 用 这 个 变量 来 在 名 为 classes 的 子 目 录 中 定位 类 (.bbclass 文 件 ) 和 在 名 为 conf 的 子 目 录 中 定位 配置 文件 (.conf 文 件 ) 以 及 子 目录 


- BBFILES: 这 个 变量 包含 针对 菜谱 文件 的 、 带 有 通配符 的 路 径 列 表 。 


层 通常 增加 指向 它 顶 级 目录 的 路 径 到 包含 在 BBPATH 中 的 路 径 列 表 中 。BitBake 在 它 开 始 解 析 某 一 层 中 的 文件 时 ， 会 自动 地 设置 变量 LAYERDIR 为 到 
那个 层 顶级 目录 的 路 径 


层 也 增加 指向 它 所 提供 的 菜谱 文件 的 路 径 到 包含 在 BBFILES 变 量 中 的 文件 路 径 列 表 中 。 文 件 路 径 代表 包含 了 层 的 菜谱 的 目录 结构 ， 根 据 惯例 ， 它 是 市 
有 2 级 子 目录 的 布局 ， 正 如 在 第 3 章 中 所 解释 的 。 


3 个 变量 BBFILE COLLECTIONS, BBFILE PATTERN, BBFILE PRIORITY 提 供 BitBake 关 于 如 何 定位 和 在 考虑 到 其 他 层 的 情况 下 如 何 对 待 这 个 层 的 菜 
谱 的 信息 : 


- BBFILE COLLECTIONS: 包含 已 配置 层 的 名 字 的 列表 。 这 个 列表 被 BitBake 使 用 以 在 它 的 数据 目录 中 找到 其 他 BBFILE _*# 变 量 。 通 常 每 个 层 都 增加 
它 自己 的 名 字 到 这 个 列表 。 


- BBFILE PATTERN: 告诉 BitBake 如 何 从 BBFILES 的 这 一 层 中 定位 菜谱 文件 的 正则 表达 式 。 层 所 设置 的 变量 值 对 应 于 它 增 加 到 BBFILES 变 量 的 路 
径 。 因 为 所 有 在 BBFILES 中 的 路 径 都 以 层 的 顶级 目录 开头 ， 所 以 这 个 正则 表达 式 反映 了 那个 惯例 。 变 量 的 名 字 必 须 追 加 下 划 线 C) 和 层 的 名 字 。 


-BBFILE PRIORITY: 向 包含 在 该 层 中 的 菜谱 赋予 优先 级 。 变 量 的 名 字 必 须 追 加 层 的 名 字 。 


大 的 优先 级 值 对 应 于 高 的 优先 级 。 如 果 市 有 相同 名 字 的 菜谱 出 现在 多 于 一 个 层 中 ， 那 么 优先 级 是 特别 重要 的 。 在 这 种 情况 下 ，BitBake 从 市 有 高 优先 
级 的 层 中 选取 菜谱 ， 即 使 包含 在 低 优 先 级 层 中 的 菜谱 拥有 比 高 优先 级 层 中 的 菜谱 更 新 的 版 本 。 


优先 级 也 决定 了 BitBake 以 什么 顺序 追加 追加 文件 到 菜谱 。 来 自 高 优先 级 层 的 追加 文件 在 来 自 低 优先 级 层 的 追加 文件 之 后 被 增加 。 


在 大 部 分 情况 下 ， 你 直接 从 执行 或 者 构建 环境 的 顶级 目录 中 执行 BitBake。 如 果 ， 因 为 某 些 原因 ， 从 顶级 目录 执行 不 是 合适 的 ， 那 么 你 可 以 在 局 动 
BitBake 前 设置 BBPATH 变 量 : 


S BBPATH="/absolute/path/to/build_env" bitbake <target> 


注意 ，BitBake 期 望 BBPATH 变 量 包含 绝对 路 径 ; 否则 ， 它 找 不 到 配置 文件 conf/bblayers.conf。 


在 解析 conf/bblayers.conf 之 后 ，BitBake 寻 找 配 置 文件 conf/bitbake.conf， 它 提供 了 构建 系统 设置 。 如 果 层 没有 被 使 用 并 且 因 此 没有 
conf/bblayers.conf 文 件 存 在 ， 那 么 BBPATH 变 量 需 要 进行 如 前 所 示 的 设置 ， 并 且 conf/bitbake.conf 必 须 包含 用 于 BBFILES 的 变量 赋值 。 


在 定位 和 解析 conf/bitbake.conf 以 及 其 他 配置 文件 之 后 ，BitBake 定 位 和 解析 所 有 类 。 至 少 一 个 包含 在 文件 base.bbclass 中 的 base 类 必须 存在 以 使 
得 BitBake 正 确 地 操作 。 这 个 类 提供 了 基本 的 功能 和 任务 ， 包 括 默认 的 build 任 务 。 


4.2.2 BitBake 命 令 行 


用 --help 选 项 运行 BitBake 提 供 了 这 个 工具 的 命令 行 选项 的 概览 ( 见 程序 清单 4-3) 。 
程序 清单 4-3 ”BitBake 命 令 行 选项 


$ bitbake --help 
Usage: bitbake [options] [recipename/target ...] 


Executes the specified task (default is 'build') for a given set of 
target recipes (.bb files). It is assumed there is a conf/bblayers.conf 
available in cwd or in BBPATH which will provide the layer, BBFILES and 
other configuration information. 

Options: 

--version show program's version number and exit 

-h, --help show this help message and exit 

-b BUILDFILE, --buildfile=BUILDFILE 
Execute tasks from a specific .bb recipe directly. 
WARNING: Does not handle any dependencies from 
other recipes. 

-k, --continue Continue as much as possible after an error. While 
the target that failed and anything depending on it 
cannot be built, as much as possible will be built 
before stopping. 


-a, --tryaltconfigs Continue with builds by trying to use alternative 
providers where possible. 

-f, --force Force the specified targets/task to run 
(invalidating any existing stamp file). 

-c CMD, --cmd=CMD Specify the task to execute. The exact options 


available depend on the metadata. Some examples 
might be 'compile' or '‘populate_sysroot' or 
'listtasks' may give a list of the tasks available. 
-C INVALIDATE STAMP, --clear-stamp=INVALIDATE_ STAMP 
Invalidate the stamp for the specified task such as 
‘compile' and then run the default task for the 
specified target(s). 
-r PREFILE, --read=PREFILE 
Read the specified file before bitbake.conf. 
-R POSTFILE, --postread=POSTFILE 
Read the specified file after bitbake.conf. 


-v, --verbose Output more log message data to the terminal. 

-D, --debug Increase the debug level. You can specify this more 
than once. 

-n, --dry-run Don't execute, just go through the motions. 

-S, --dump-signatures 


Don't execute, just dump out the signature 
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-p, --parse-only Quit after parsing the BB recipes. 


-s, --show-versions Show current and preferred versions of all recipes. 

-e, --environment Show the global or per-package environment complete 
with information about where variables were 
set/changed. 

-g, --graphviz Save dependency tree information for the specified 
targets in the dot syntax. 

-I EXTRA_ASSUME_PROVIDED, --ignore-deps=EXTRA_ASSUME_PROVIDED 


Assume these dependencies don't exist and are 

already provided (equivalent to ASSUME PROVIDED). 

Useful to make dependency graphs more appealing. 
-1 DEBUG_DOMAINS, --log-domains=DEBUG_DOMAINS 

Show debug logging for the specified logging 


domains. 

-P, --profile Profile the command and save reports. 

-u UI, --ui=UI The user interface to use (e.g. knotty, hob, 
depexp). 


-t SERVERTYPE, --servertype=SERVERTY PE 
Choose which server to use, process or xmlrpc. 
--revisions-changed Set the exit code depending on whether upstream 
floating revisions have changed or not. 
--server-only Run bitbake without a UI, only starting a server 
(cooker) process. 
-B BIND, --bind=BIND The name/address for the bitbake server to bind to. 


--no-setscene Do not run any setscene tasks. sstate will be 
ignored and everything needed, built. 
--remote-server=REMOTE SERVER 
Connect to the specified server. 
-m, --kill-server Terminate the remote server. 
--observe-only Connect to a server as an observing-only client. 


第 一 上 腿 ， 命 令 行 选项 的 数量 看 起 来 是 巨大 的 ， 但 是 它们 可 以 被 简单 分 解 成 一 些 功 能 块 。 


显示 程序 版 本 和 帮助 


执行 市 依赖 处 理 的 构建 
用 目标 (菜谱 文件 不 市 .bb 后 绎 的 基 名 称 ) 来 调用 BitBake， 运 行 由 变量 BB_DEFAULT_TASK 定 义 的 默认 任务 ， 通 单 是 build : 


9 bitbake core-image-minimal 


BitBake 评 佑 目标 和 任务 的 所 有 依赖 性 ， 并 且 在 实际 构建 目标 前 以 正确 的 、 由 依赖 链 所 强加 的 顺序 执行 所 有 依赖 任务 。 没 有 被 实现 的 依赖 性 会 导致 错 


任何 错误 条 件 都 导致 BitBake 停 止 执 行 ， 即 使 其 他 任务 是 可 以 被 执行 的 。 使 用 -k 选 项 ， 
S bitbake -k core-image-minimal 


命令 BitBake 继 续 构 建 ， 即 使 一 个 或 者 多 个 任务 已 经 失败 了 。BitBake 尽 可 能 地 构建 直到 失败 的 任务 阻止 目标 和 任何 依赖 于 它 的 事物 。 


使 用 不 带 版 本 和 修订 的 目标 总 是 构建 软件 包 的 最 新 版 本 或 者 由 PREFERRED VERSION 变 量 指定 的 版 本 。 版 本 和 修订 号 码 可 以 被 加 到 目标 名 字 上 以 构 
建 特定 的 版 本 而 不 管 它 是 否 是 最 新 版 本 并 且 不 管 PREFERRED_VERSION 的 值 。 如 下 命令 


S bitbake editor-1.0 
S bitbake editor-2.0-r3 


分 别 构建 editor 软 件 包 的 1.0 版 本 和 2.0 版 本 /修订 r3。 
执行 不 市 依赖 处 理 的 构建 
使 用 -b 或 者 --buildfile 选 项 和 菜谱 文件 的 名 字 ， 包 括 .bb 后 级， 执行 菜谱 的 默认 任务 但 是 不 市 构建 依赖 : 


9 bitbake -b core-image-minimal .bb 
9 bitbake --buildfile=core-image-minimal.bb 


如 果 core-image-minimal 的 任何 依赖 都 不 被 实现 ， 那 么 BitBake 以 错误 消息 退出 而 不 尝试 构建 依赖 。 
执行 特定 任务 
目标 的 特定 任务 可 以 使 用 -c 或 者 --cmd 选 项 来 执行 : 


S bitbake editor -c compile 
S bitbake editor --cmd=compile 


由 于 其 正在 执行 默认 任务 ， 所 以 依赖 都 是 被 遵守 的 ， 并 且 如 果 它 们 还 没有 被 实现 那么 便 会 被 构建 。 使 用 


S bitbake -b editor.bb -c compile 
S bitbake -b editor.bb --cmd=compile 


尝试 运行 编译 任务 而 不 构建 任何 依赖 。 
强制 执行 


BitBake 为 每 一 个 成 功 完成 的 任务 创建 时 间 戳 。 如 果 ， 在 任务 的 后 续 运 行 上 ， 任 务 的 时 间 戳 是 当前 的 或 者 是 更 新 于 那个 任务 所 依赖 的 所 有 任务 的 时 间 
戳 ， 那 么 BitBake 不 运行 这 个 任务 。 选 项 -C 或 者 --clear-stamp 命 令 BitBake 运 行 任务 而 不 管 时 间 戳 : 


9 bitbake zlib -C compile 
9 bitbake zlib --clear-stamp=compile 


这 些 选 项 也 可 以 和 -b 或 者 --buildfile 选 项 结合 。 
-C 或 者 --clear-stamp 选 项 等 同 于 使 用 


S bitbake zlib -c compile -f 
S bitbake zlib -c compile --force 


任何 构建 系统 的 重要 功能 是 ， 如 果 任 何 输入 变化 ， 那 么 决定 构建 过 程 的 什么 部 分 必须 被 再 次 执行 的 能 力 。 为 了 这 个 目的 ，BitBake 实 现 了 共享 状态 缓 
仔 。 共 享 状态 缓存 在 任务 级 别 操作 ， 并 且 为 每 个 菜谱 的 每 个 任务 决定 它 的 输入 是 什么 以 及 存储 任务 增加 什么 输出 到 构建 过 程 。 如 果 任 务 的 输入 没有 变 
化 ， 那 么 在 后 续 构 建 上 ， 它 的 输出 不 变 。 如 果 是 那 种 情 ; 况 ， 那 么 BitBake 从 共享 状态 缓存 获取 和 恢复 任务 的 输出 而 不 是 运行 实际 的 任务 。 从 共享 状态 缓存 
获取 和 恢复 任务 输出 的 操作 被 称 为 Set-scene。 如 果 set-scene 是 不 被 希望 的 ， 那 么 可 以 使 用 --no-setscene 选 项 来 关闭 它 : 


S bitbake zlib -c compile --no-setscene 
选项 --no-setscene 也 可 以 结合 -b 或 者 --buildfile 选 项 。 
共享 状态 缓存 是 强 有 力 的 功能 ， 其 通过 重用 来 自 缓存 的 已 经 处 理 过 的 任务 输出 来 极 大 地 加 速 构 建 过 程 。 


展示 元 数据 


为 了 调试 目的 ， 列 出 所 有 元 数据 是 非常 有 帮助 的 。 选 项 -e 或 者 --environment 在 BitBake 已 完成 解析 过 程 后 立即 显示 所 有 元 数据 、 变 量 和 函数 。 


S bitbake -e 
S bitbake --environment 


当 和 目标 或 者 菜谱 名 字 一 起 使 用 的 时 候 ， 命 令 展示 BitBake 应 用 到 构建 那个 包 的 环境 设置 : 


S bitbake -e zlib 
S bitbake --environment zlib 


这 些 选 项 也 可 以 和 -b 或 者 --buildfile 选 项 结合 。 
因为 展示 包含 国 数 的 所 有 元 数据 会 产生 大 量 滚动 在 屏幕 上 的 输出 ， 所 以 建议 使 用 例如 grep 的 实用 工具 来 过 滤 需 要 的 信息 。 
另外 有 帮助 的 选项 是 -s 或 者 --show-versions， 它 展示 所 有 菜谱 和 版 本 号 的 列表 : 


S bitbake -s 
S bitbake --show-versions 


这 些 选 项 总 是 列 出 整个 菜谱 名 单 ， 使 用 过 滤 实用 工具 可 能 有 助 于 缩短 列表 成 你 正在 寻找 的 条 目 。 
创建 依赖 性 关系 图 (Dependency Graph) 


BitBake 可 以 用 DOT 语 言 创 建 描 述 包 依赖 性 的 图 形 。DOT 是 可 以 描述 无 向 图 和 有 向 图 并 且 用 属性 注释 它们 以 及 节点 和 边 的 普通 文本 图 形 描 述 语言 。 
来 自 Graphviz 包 (www.graphviz.org) 的 软件 应 用 可 以 读 取 DOT 文 件 并 且 以 图 形 形 式 演 染 它 们 。 如 下 命令 


9 bitbake -g zlib 


在 当前 工作 目录 中 使 用 DOT 语 言 创建 3 个 描述 zlib 包 的 依赖 性 的 文件 : 
- package-depends.dot: 实际 包 级 别 且 详细 说 明子 包 的 依赖 性 关系 图 
- task-depends.dot: 任务 级 别 的 依赖 性 关系 图 
-pn-depends.dot: 包 名 级 别 且 不 详细 说 明子 包 的 依赖 性 关系 图 
作为 一 种 对 -g 选 项 的 选择 ，--graphviz 选 项 可 以 被 使 用 。 
如 果 Graphviz 包 是 被 安 半 在 开发 系统 上 的 ， 那 么 你 可 以 从 这 些 文件 创建 依赖 性 天 系 图 的 图 形 化 泻 染 。 如 下 命令 


S dot -Tpng -o pn-depends.png pn-depends.dot 


创建 包含 依赖 性 天 系 图 的 、png 格 式 的 图 片 。 依 赖 性 关系 图 往往 变 得 相当 大 ， 因 为 所 有 依赖 性 ， 包 括 例如 编译 器 和 C 库 在 内 的 通用 依赖 性 ， 都 被 展 
。 你 可 以 使 用 -| 或 者 --ignore-deps 选 项 来 省 略 通 用 的 包 : 


zji 


S bitbake -g zlib -I expat 
S bitbake -g zlib --ignore-deps="expat" 


这 些 命令 把 expat 包 从 依赖 性 关系 图 中 去 除 。 不 幸 的 是 ， 你 必须 要 逐个 指定 每 一 个 要 从 依赖 性 关系 图 中 去 除 的 包 ， 因 为 没有 方法 可 以 用 单一 选项 一 次 
性 去 除 通 用 依赖 性 。 


由 BitBake 和 后 成 的 依赖 性 关系 图 也 包括 传递 依赖 ， 使 得 图 比 必要 的 大 。 你 可 以 用 Graphviz 包 中 的 tred 命 令 去 除 传递 依赖 : 


$ tred pn-depends.dot > pn-depends-notrans.dot 


BitBake 也 包括 了 内 置 的 、 用 于 依赖 性 关系 图 的 可 视 化 工具 一 一 依赖 性 浏览 器 。 使 用 


$ bitbake -g -u depexp zlib 


启动 依赖 性 浏览 器 ， 显 示 在 图 4-1 中 。 
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图 4-1 依赖 性 浏览 器 


依赖 性 浏览 器 按照 每 个 包 列 出 运行 时 、 构 建 时 和 逆向 依赖 性 。 运 行 时 依赖 性 是 软件 包 在 运行 时 所 要 求 的 全 部 依赖 性 。 构 建 时 依赖 性 必须 在 构建 软件 
时 人 逢 实现 。 逆 向 依赖 性 列表 显示 所 有 依赖 于 这 个 包 的 包 。 


提供 和 覆盖 配置 数据 


选项 -[ 或 者 --read 和 -R 或 者 --postread 通 过 便利 的 方法 来 提供 额外 的 配置 数据 或 者 覆盖 现 有 的 设置 而 不 修改 构建 环境 的 任何 配置 文件 ， 例 如 
bitbake.conf 或 者 local.conf。 


作为 替代 通过 命令 上 的 shell 直 接 设置 变量 的 方法 ， 正 如 前 面 我 们 所 看 到 的 ，-[ 或 者 --read 可 以 用 来 在 工具 读 取 任何 其 他 文件 之 前 向 BitBake 提 供 配 置 
数据 : 


S bitbake -r prefile.conf <target> 
S bitbake --read prefile.conf <target> 


这 种 技术 可 以 用 于 目 动 构建 系统 蔡 代 bblayers.conf 文 件 来 设置 BBPATH 和 BBLAYERS 变 量 以 动态 地 设置 构建 环境 。 


使 用 


S bitbake -R postfile.conf <target> 
S bitbake --postread postfile.conf <target> 


人 允许 方便 地 覆盖 由 构建 环境 的 任何 其 他 配置 文件 做 出 的 变量 设置 ， 因 为 BitBake 在 它 解 析 完 所 有 配置 文件 以 后 再 处 理 postfile.conf。 例 如 ， 机 器 或 者 
皮 行 版 配置 可 以 被 动态 地 履 盖 ， 或 者 变量 可 以 为 了 调试 目的 而 家 设置 。 


运行 BitBake 服 务 器 


BitBake 是 客户 端 - 服 务 器 应 用 。 每 次 你 运行 BitBake， 它 就 在 后 台 局 动 名 为 cooker 的 服务 器 或 者 后 端 进程 以 及 用 于 用 户 界 面 的 客户 端 或 者 前 端 进 
程 。cooker 后 端 进程 进行 所 有 元 数据 文件 处 理 以 及 实际 的 构建 ， 最 终 创建 多 个 线程 。 当 以 这 种 多 合 一 模式 局 动 时 ， 后 端 和 前 端 进程 使 用 基于 管道 的 进程 


间 通 信 (Interprocess Communication, IPC) 来 交换 信息 。 


后 端 和 前 端 进 程 也 可 以 在 不 同 的 系统 上 独立 地 启动 ， 使 得 你 可 以 远程 启动 和 监控 构建 过 程 ， 为 了 从 构建 环境 中 局 动 BitBake 服 务 器 进程 ， 使 用 如 下 命 


令 : 
S bitbake --server-only --servertype=xmlrpc --bind=<ip>:<port> 


这 个 命令 启动 了 作为 后 台 进 程 、 监 听 在 IP 地 址 <ip> 和 端口 <port> 的 BitBake 服 务 器 ， 你 可 以 绑 定 服 务 器 到 任何 IP 地 址 ， 例 如 本 地 (localhost) 或 者 
你 构建 系统 的 任何 网 络 接口 的 IP 地 址 。 你 也 可 以 使 用 任何 端口 ， 只 要 它 不 是 特权 所 有 或 者 正在 使 用 中 。 在 局 动 BitBake 时 ， 你 必须 指定 -- 
servertype=xmlrpc。 昌 然 这 看 起 来 是 见 余 的 ， 因 为 process 和 xmlrpc 是 当前 仪 有 的 2 种 被 支持 的 进程 间 通 信 方 法 ， 并 且 process 不 能 和 服务 器 模式 一 起 使 
用 ， 在 未 来 ，BitBake 可 能 文 持 额 外 的 用 于 服务 器 模式 的 进程 间 通 信 方 法 。 


为 了 使 用 默认 的 文本 终端 类 型 的 用 户 接口 连接 到 运行 中 的 BitBake 服 务 器 并 且 执 行 售 令 ， 使 用 如 下 命令 : 


bitbake --servertype=xmlrpc --remote-server=<ip>:<port> <target> 


它 在 远程 服务 器 上 局 动 针 对 <target> 的 构建 过 程 。 
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BitBake 使 用 元 数据 来 控制 构建 过 程 。 总 的 来 癌 ， 元 数据 摘 述 软件 包 ， 也 摘 述 它们 是 如 何 航 构建 以 及 它们 如 何 互相 天 联 和 互相 依赖 。BitBake 区 分 2 种 
类 型 的 元 数据 : 


变量 : 变量 被 赋予 值 和 等 价 于 值 的 表达 式 。 变 量 可 以 是 对 整个 构建 系统 全 局 有 效 的 或 者 对 当前 的 上 下 文本 地 有 效 ， 例 如 对 于 特定 的 菜谱 。 许 多 
BitBake 元 数据 变量 不 仅 包 含 单一 的 值 ， 也 包含 由 空格 分 隔 的 值 的 列表 。 


- 可 执行 元 数据 : 可 执行 元 数据 是 嵌入 在 菜谱 和 类 中 的 由 BitBake 在 菜谱 的 上 下 文中 执行 的 函数 和 任务 。 
元 数据 被 组 织 进 5 类 文件 : 


. 配置 文件 (.conf) : 放 在 配置 文件 中 的 元 数据 是 全 局 的 并 且 影 响 所 有 引用 它们 的 菜谱 。 配 置 文件 可 能 只 包含 变量 而 没有 可 执行 元 数据 。 如 果 相 同 
的 交 量 在 多 个 配置 文件 中 被 赋值 ， 那 么 由 层 优先 级 建立 的 顺序 决定 哪个 设置 生效 。 配 置 文件 bitbake.conf 有 最 低 的 优先 级 ， 构 建 环境 的 本 地 配置 文件 
local.conf 有 最 高 的 优先 级 。 


菜谱 文件 (bb) : 菜谱 包含 描述 特定 软件 包 以 及 如 何 构建 该 软件 包 的 元 数据 。 菜 谱 通 常 提供 任务 形式 的 ， 带 有 用 于 下 载 、 解 压 、 打 补丁 、 编 译 、 


打包 和 安装 软件 包 的 指令 的 可 执行 元 数据 。 


- 类 文件 (.bbclass) : 类 文件 提供 一 种 简单 的 、 用 于 菜谱 共享 相同 构建 指令 的 继承 机 制 。BitBake 在 层 的 classes 子 目录 中 搜索 类 文件 。 菜 谱 可 以 通过 


使 用 inherit 指 令 ， 用 类 文件 的 名 字 引 用 它们 来 包含 类 文件 。 类 是 全 局 的 ， 这 意味 着 ， 位 于 层 中 的 菜谱 可 以 从 构建 环境 包含 的 任何 其 他 层 中 继承 类 。 
- 追加 文件 (.bbappend) : 追加 文件 是 菜谱 文件 的 扩展 。 层 使 用 追加 文件 来 扩展 包含 在 其 他 层 中 的 菜谱 。 追 加 文件 必须 拥有 和 它 所 扩展 的 


菜谱 相同 的 基 名 称 ， 但 其 是 .bbappend 后 级 而 不 是 .bb 后 级 。 追 加 文件 也 必须 要 有 和 它 正 在 追加 的 菜谱 相同 的 相对 于 层 的 根 目录 的 路 径 。 追 加 文件 要 么 增加 
额外 的 元 数据 要 么 修改 定义 在 菜谱 中 的 元 数据 。 追 加 文件 的 内 容 是 逐 字 追加 到 原始 菜谱 的 。 如 果 来 自 不 同 层 的 追加 文件 追加 相同 的 菜谱 ， 那 么 层 的 优先 
级 决定 BitBake 以 何 种 顺序 追加 文件 到 菜谱 。 


~ 


包含 文件 (inc) : 通过 使 用 include 和 require 指 令 ， 任 何 元 数据 文件 可 以 包含 其 他 文件 。 包 含 文件 通常 提供 多 个 元 数据 文件 共享 的 元 数据 。 包 含 文 
件 的 内 容 被 插入 到 正在 包含 的 元 数据 文件 的 各 个 指令 所 在 的 位 置 。 这 当然 承担 着 圆 形 夹杂 的 风险 ，BitBake 会 检测 并 对 这 种 情况 作出 警告 。 文 件 包含 不 限 
于 相同 的 层 ， 但 是 层 中 的 菜谱 可 以 包含 来 自 另 一 层 的 文件 。,inc 文 件 后 组 是 完全 惯例 的 。 一 个 元 数据 文件 可 以 包含 任何 其 他 元 数据 文件 ; 然而 ， 包 含 可 # 
了 元 数据 的 文件 可 能 仅仅 被 菜谱 、 追 加 文件 和 类 所 包含 。 


a 


BitBake 在 启动 后 立即 解析 元 数据 文件 并 且 创 建 元 数据 缓存 。 这 个 缓存 本 质 上 是 BitBake 的 元 数据 字典 的 持久 形式 。 只 要 元 数据 没有 变化 ，BitBake 从 
缓存 中 读 取 它 会 极 大 地 减少 启动 时 间 。 
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BitBake 元 数据 文件 使 用 相当 简单 明了 的 语法 。 在 某 种 程度 上 ， 它 类 似 于 你 可 能 熟悉 的 、 来 自 Makefiles 和 shell 脚 本 的 语法 。 


44.1 注释 


在 元 数据 文件 内 的 注释 被 前 缀 以 # 符 号 。 注 释 必 须 在 第 一 列 开始 ， 除 非 它们 被 置 于 shell 或 者 Python 函数 内 部 ( 见 程 序 清单 4-4) 。 
程序 清单 4-4 ”注释 
# This is a comment. 
# This is an invalid comment, which causes a parse error. 
SUMMARY = "Sample file with comments" # this comment is also invalid 
helloworld () { 
# comments in shell functions can start on any column 


# and can also be added after statements 
echo "Hello World!" # this is okay in a shell function 


} 
python printdate () { 
# comments in Python functions can start on any column 
# and can also be added after statements 
import time 
print time.strftime("%Y%m%d", time.gettime()) # ok too 
} 


SRS +, ASPIRE AERA RAES DR, FAR SRA. 
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BitBake 变 量 是 无 类 型 的 。BitBake 把 所 有 赋 给 变量 的 值 都 视 作 字符 串 。 
变量 名 


BitBake 变 量 名 可 能 包含 大 写 和 小 写字 母 、 数 字 以 及 特殊 字符 : 下 划 线 (_) 、 连 接 符 (-) . 1S (,) 、 加 号 (+) RRS (~) 。 它 们 也 可 以 以 
任何 这 些 字符 开头 。 


虽然 前 面 的 任何 字符 在 变量 名 中 都 是 被 允许 的 ， 但 是 依据 惯例 ， 只 有 大 写字 母 和 下 划 线 是 被 使 用 的 ， 并 且 所 有 的 变量 名 以 大 写字 母 开 头 。 


加 


pC -== Wy 
SEB 


在 配置 文件 (也 就 是 ， 以 .conf 结 尾 的 文件 ) 中 定义 的 变量 是 全 局 的 并 且 在 所 有 菜谱 中 可 见 。 在 菜谱 中 定义 的 变量 是 仅仅 本 地 于 菜谱 的 。 菜 谱 由 它们 
目 己 的 名 字 空 间 ， 在 菜谱 中 被 赋值 的 全 局 变量 仅仅 当 BitBake 处 理 那 个 菜谱 的 时 候 才 保持 该 值 。 


变量 赋值 


所 有 BitBake 变 量 赋值 都 是 市 有 包围 值 的 成 对 分 隔 符 的 字符 串 字 面 量 。 分 隔 符 要 么 是 双 3 引 号 (") 要 么 是 单 引 号 (') 。 按 照 惯 例 ， 双 引号 是 更 受 欢迎 
的 。 


直接 赋值 (= ) 


可 以 使 用 = 符号 来 给 变量 赋值 。 使 用 
VAR = "value" 
把 value 赋 给 变量 VAR。 在 变量 赋值 中 的 引用 可 以 通过 使 用 反 斜 杠 (\) 作为 转 义 字符 或 者 单 引号 来 实现 : 


VAR1 = "This is a \"quotation\" inside a variable assignment" 
VAR2 "This is a second 'quotation' inside a variable assignment" 


为 了 可 阅读 性 ， 第 2 种 方法 是 更 受 欢 迎 的 。 
默认 赋值 (?=) 
可 以 使 用 ?= 赋值 操作 符 赋 予 变 量 默认 值 : 


A ?= "valuel" 
B ?= "value2" 
B ?= "value3" 
C ?= "value4" 
C = “values” 


如 果 变 量 以 前 没有 被 设置 过 ， 那 么 它 被 赋予 默认 值 。 如 果 它 在 默认 赋值 之 前 已 经 被 设置 过 了 ， 那 么 保留 它 的 值 。 在 前 面 的 赋值 序列 中 ， 如 果 A 以 前 没 
有 被 设置 过 ， 那 么 A 包 售 value1。B 包 含 value2， 因 为 第 一 次 使 用 ?= 操作 符 设置 了 变量 。 

= 操作 符 履 兰 任 何以 前 的 默认 赋值 ， 因 此 ，(C 包 含 value>。 

弱 默 认 赋 值 (??=) 


当 使 用 弱 或 者 惰性 默认 赋值 操作 待 ?= 时 ， 赋 值 直到 解析 过 程 结束 才 友 生 ， 以 全 于 针对 变量 的 最 后 而 不 是 第 一 个 ?= 赋值 会 被 使 用 : 


2??= "valuel" 
2?= "value2" 
2??= "value3" 
?= "value4" 
77= ®yalues* 
= "value6" 
2??= "value7" 
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在 这 个 例子 中 ， 如 果 A 以 前 没有 被 设置 过 ， 那 么 A 包含 value1。 如 果 B 以 前 没有 被 设置 过 ， 那 么 B 包 含 value3， 因 为 赋值 直到 解析 过 程 结束 才 发 生 。C 
包含 value4，D 包 含 value6， 因 为 ?= 和 = 操作 符 履 盖 ?? = 操作 符 。 


变量 扩展 
BitBake 变 量 可 以 引用 其 他 BitBake 变 量 的 内 容 : 


VAR1 = "jumps over" 

VAR2 = "The quick brown fox ${VAR1} the lazy dog." 

可 以 使 用 $0 引用 操作 符 和 变量 名 来 引用 变量 的 内 容 。 在 这 个 例子 中 ，VAR2 包 含 “The quick brown fox jumps over the lazy dog.” . 
直接 变量 扩展 


变量 扩展 直到 变量 实际 被 使 用 到 时 才 友 生 。 人 简单 地 赋值 包含 变量 扩展 的 表达 陈 不 会 扩展 引用 的 变量 。 然 而 ， 赋 值 操作 符 := 引 起 了 赋值 上 的 直接 扩 


VAR1 = "jumps over" 

VAR2 = "S{VAR1} the lazy dog. " 

VARL = "table on." 

VAR3 = "The rain in Spain ${VAR1} the plain." 
VAR4 := "The quick brown fox S${VAR2}" 


变量 VAR4 包 含 “The quick brown fox falls on the lazy dog.” 因 为 在 VAR2 赋 值 中 包含 的 VAR1 直 到 VAR2 的 内 容 在 使 用 := 操作 符 赋 值 VAR4 而 被 
引用 时 才 被 扩展 。 然 而 ， 截 至 那 时 ，VAR1 的 值 已 经 被 设置 成 了 falls on, 


Python 变量 扩展 
BitBake 可 以 对 变量 赋值 中 的 Python 表达 式 进 行 求 值 : 
DATE = "S${@time.strftime('%A %B %d, %Y', time.gettime()) }" 


TODAY = “Today isv ${DATE}." 


@ 操 作 符 告诉 BitBake 把 随后 的 表达 式 视 作 Python 人 代码。 这 个 代码 必须 被 求 值 成 值 。 在 这 个 例子 中 ，TODAY 将 包含 类 似 于 “Today is: Friday April 
1,2016.” AYE. 


变量 追加 和 前 新 增 (Prepending) 
变量 内 容 可 以 使 用 追加 和 前 新 增 操作 符 来 和 其 他 字符 串 字 面 量 以 及 来 自 其 他 变量 的 内 容 连 接 。 
市 空格 的 追加 (+=) 和 前 新 增 (=+) 


+= 和 =+ 操 作 符 分 别 追加 和 前 新 增 变 量 ， 同 时 在 值 之 间 增 加 空格 : 


VARI = "12" 


VARI += "34" 
VAR2 = "89" 
VARA =+ "67" 
VAR3 = "5" 


VAR3 += "S{VAR1}" 
VAR3 =+ "S{VAR2}" 


这 个 例子 结果 是 ， 变 量 VAR1 包 含 12 ” 34， 变量 VAR2 包 含 67 89 以 及 变量 VAR3 包 含 12 34 5 67 89, 


不 带 空格 的 追加 (=) 和 前 新 增 (=.) 


.= 和 =. 操 作 符 分 别 妃 加 和 前 新 增 变 量 而 不 在 值 之 间 放 置 额 外 的 空格 : 


VARI = "12" 

VARI .= "34" 

VAR2 = "89" 

VAR2 =. "67" 

VAR3 = "5" 

VAR3 «= "S{VAR1}" 
VAR3 =. "${VAR2}" 


这 个 例子 的 结果 是 ， 变 量 VAR1 包 含 1234， 变 量 VAR2 包 含 6789， 变 量 VAR3 包 含 123456789。 
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使 用 append 和 prepend 操 作 符 追加 和 前 新 增 


也 可 以 使 用 加 到 变量 名 上 的 特殊 的 append 和 _prepend 操 作 符 来 被 追加 和 前 新 增 变 量 值 : 


VARL = "12" 
VAR1_append = "34" 
VAR2 = "89" 
VAR2_prepend = "67" 
VARJ = "5" 


VAR3_append = "S${VAR1}" 
VAR3_prepend = "S${VAR2}" 


这 个 例子 的 结果 是 ， 变 量 VAR1 包 含 1234， 变 量 VAR2 包 含 6789， 变 量 VAR3 包 含 123456789。 


_append 和 _prepend 操 作 符 不 搬入 任何 空格 。 如 果 空 格 是 需要 的 ， 那 么 你 必须 用 字符 串 字 面 量 包括 它 们 。 
去 除 (_remove) 
生变 量 中 包含 空格 分 隔 的 值 列表 的 单一 值 可 以 通过 _remove 操 作 符 去 除 : 


VARI = "123 456 789 123456789 789 456 123 123 456" 
VAR1 remove = "123" 


VAR1 remove = "456" 


这 个 例子 的 结果 是 ， 变 量 VAR1 包 含 字 符 串 789 123456789 789, 


条 件 变 量 赋值 


变量 OVERRIDES 包 含 由 冒号 (:) 分 隔 的 值 的 列表 。 每 个 值 代表 需要 被 实现 的 条 件 : 


OVERRIDES = "conda:condb:condc" 


BitBake 从 右 到 左 处 理 条 件 ， 这 意味 着 ,右边 的 优先 级 高 于 左边 的 。 


条 件 变量 设置 
变量 通过 用 下 划 线 (_) 追加 条 件 到 变量 名 而 被 有 条 件 地 设置 ; 


OVERRIDES "sun:rain:snow" 
PROTECTION "unknown" 
PROTECTION sun ‘LoL ion” 


在 这 个 例子 中 ， 变 量 PROTECTION 包 含 lotion， 因 为 条 件 sun 被 包含 在 OVERRIDES 列 表 中 。 考 虑 如 下 的 例子 
列表 中 : 


OVERRIDES = "sun:rain:snow" 
PROTECTION rain = "umbrella" 
PROTECTION snow = "Sweater" 


在 这 个 例子 中 ， 变 量 PROTECTION 包 含 sweater， 因 为 条 件 snow 相 对 于 条 件 rain 有 更 高 的 优先 级 。 


在 下 面 的 例子 中 ， 变 量 PROTECTION 包 含 umbrella ， 因 为 条 件 hail 不 被 包含 在 OVERRIDES 列 表 中 : 


OVERRIDES = "Sun:rain:snow" 
PROTECTION rain "umbrella" 
PROTECTION hail ele Nb Ee a 


像 任 何其 他 元 数据 ， 变 量 OVERRIDES 也 可 以 引用 其 他 变量 的 内 容 : 


OVERRIDES = 
OTHER = 


"Sun:rain:snow:${OTHER}" 
"Hail? 


area 


FRAPS a Se CAT BBS SAR EA FS EIB oe E. 
编译 器 机 器 依赖 的 代码 。 


这 个 方法 被 构建 系统 频繁 使 用 ， 例 如 


条 件 仍 加 和 前 新 增 


条 件 也 可 以 用 来 追加 和 前 新 增 变 量 : 


OVERRIDES = "Sun:rain:snow" 

PROTECTION = "Sweater" 

PROTECTION_append_rain = "umbrella" 
这 个 例子 的 结果 是 ，PROTECTION 被 设置 成 sweater umbrella, 


用 更 高 优先 级 (更 加 靠 右 于 OVERRIDES) 追加 和 前 新 增 会 更 优先 ， 正 如 条 件 变 量 赋值 的 情况 一 样 。 
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元 数据 文件 可 以 包含 其 他 元 数据 文件 以 允许 共享 的 设置 。 常 见 的 用 例 是 构建 相同 软件 包 的 不 同 版 本 的 菜谱 
、 安 装 目 录 等 ， 它 们 由 特定 于 要 构建 的 版 本 的 设置 以 及 实际 菜谱 来 补充 ， 例 如 下 载 位 置 和 源 文件 的 名 字 。 


“lp 


BitBake 提 供 2 个 针对 可 选 包含 和 必须 包含 的 包谷 指令 : 


， 其 中 2 个 条 件 都 被 包含 在 OVERRIDES 


， 特 定 参数 需要 被 传递 到 编译 器 用 于 


。 包 含 文件 提供 共享 的 设置 ， 例 如 构建 指 


include optional.inc # optional inclusion 
required mandatory.inc # required inclusion 


当 用 include 指 令 实现 可 选 包含 时 ，BitBake 尝 试 定位 包含 文件 ， 但 是 即使 不 能 找到 文件 ， 它 也 会 悄 无 声息 地 继续 操作 。 相 反 ， 用 required 指 令 实 现 
的 必须 包含 使 得 BitBake 以 错误 信息 退出 。 


对 大 部 分 用 例 来 说 ， 用 required 指 令 包 含 一 个 文件 是 受 欢 迎 的 ， 因 为 如 果 BitBake 不 能 定位 包含 文件 它 便 会 警告 你 ， 这 可 以 防止 错误 ,例如 在 路 径 和 
文件 名 字 中 的 错别字 。 然 而 ， 有 时 受 欢 迎 的 是 ， 提 供 不 要 求 直 接 改变 元 数据 文件 的 定制 化 方法 。 对 这 样 的 情况 来 说 ， 把 include 指 令 放 进 元 数据 文件 会 提 
供用 于 可 选 的 定制 化 的 机 制 。 如 果 定 制 化 是 希望 的 ， 那 么 包含 文件 可 以 被 提供 ,但 是 如 果 它 是 不 必要 的 并 且 包 含 文件 不 存在 ， 那 么 BitBake 简 单 地 忽略 包 


今 


指令 include 与 required 可 以 和 相对 路 径 以 及 绝对 路 径 一 起 使 用 : 


include filel.inc 
include meta-test/recipes-core/images/file2.ince 
required /home/build/yocto/file3.inc 


当 相 对 路 径 被 使 用 的 时 候 ，BitBake 尝 试 使 用 由 BBPATH 变 量 指定 的 文件 路 径 列 表 来 定位 文件 。BitBake 使 用 它 找到 的 、 有 正确 路 径 段 和 文件 名 的 第 
=NI F 


在 BitBake 定 位 到 包含 文件 后 ， 它 解析 包含 文件 的 内 容 ， 并 且 在 它 遇 到 包含 指令 的 位 置 把 内 容 插入 到 起 始 包 含 文件 。 因 此 ， 包 含 文件 可 以 覆盖 原先 由 
起 始 包 含 文件 所 做 出 的 设置 ， 反 过 来 也 一 样 ， 使 得 包含 措 令 被 放置 到 起 始 包 含 文件 的 恰当 位 置 是 重要 的 。 


当然 ， 包 含 文件 必须 符合 起 始 包 含 文 件 的 BitBake 元 数据 语法 。 菜 谱 和 类 可 以 包含 含有 配置 项 以 及 可 执行 元 数据 的 文件 。 然 而 ， 配 置 文 件 只 可 以 包含 
含有 配置 项 但 不 含有 可 执行 元 数据 的 文件 ， 因 为 后 者 在 配置 文件 中 是 不 被 支持 的 。 


锌 包含 的 文件 本 身 可 以 包含 其 他 文件 。 那 个 实践 存在 循环 包含 的 风险 ， 因 为 BBPATH 搜 索 顺 序 的 原因 ， 特 别 是 对 于 被 相对 路 径 包 含 的 文件 。 然 
而 ，BitBake 检 测 循环 包 合并 且 以 错误 信息 终止 。 


AAA 继承 


通过 类 ，BitBake 提 供 了 简单 的 继承 机 制 。 类 可 以 被 菜谱 、 奶 加 文件 和 其 他 类 用 inherit 指 令 来 继承 。 
inherit myclass 
类 是 市 有 .bbclass 文 件 名 后 缀 的 、 被 放置 进 元 数据 层 的 classes 子 目录 中 的 元 数据 文件 。 指 令 inherit 仅 仪 使 用 类 名 ， 它 是 不 这 后 缀 的 类 文件 名 的 基 名 
称 。 它 仅 仪 可 以 用 在 菜谱 、 授 加 文件 和 其 他 类 文件 中 。 
第 一 眼看 来 ， 继 承 似乎 是 非常 相似 并 且 最 终 匈 余 于 包 仿 的。 然而， 区别 在 于 BitBake 如 何 处 理 和 解析 类 : 
. BitBake 通 过 它们 的 类 名 来 识别 类 而 不 是 通过 它们 的 文件 名 和 路 径 ， 这 意味 着 类 名 字 必 须 是 在 所 有 构建 环境 包含 的 元 数据 层 中 唯一 的 。 


BitBake 在 解析 完 配 置 文件 之 后 和 解析 菜谱 之 前 会 解析 一 次 类 。 包 含 文件 是 在 BitBake 遇 到 包含 指令 时 被 解析 的 。 如 果 相 同 的 包含 文件 是 被 多 个 其 他 
文件 所 包含 的 ， 那 么 在 起 始 包 含 文件 的 上 下 文中 ，BitBake 多 次 解析 相同 的 文件 。 这 使 得 类 对 于 由 许多 不 同 菜谱 共 享 的 构建 指令 来 说 是 更 加 高 效 的 机 制 。 
然而 ， 对 于 菜谱 构建 相同 软件 包 的 不 同 版 本 来 说 ， 使 用 包含 文件 是 好 的 选择 ， 因 为 通常 一 次 仅 有 特定 软件 包 的 一 个 版 本 是 被 构建 的 。 


- BitBake 的 DataSmatt 写 时 复制 (Copy-on-Write, COW) 数据 存储 仅仅 维护 类 的 一 个 副本 ， 即 使 类 文件 被 数 百 个 菜谱 使 用 ， 使 用 包含 文件 也 可 能 导致 
数据 的 重复 。 


通用 类 的 使 用 简化 了 很 多 菜谱 。 例 如 ， 针 对 构建 软件 包 的 autotools 类 利用 GNU Autotools 配 置 机 制 可 以 将 菜谱 减少 为 数 行 代码 ( 见 程 序 清 单 4- 
5) o 


程序 清单 4-5 使 用 autotools 类 


SUMMARY = "GNU nano - an enhanced clone of the Pico text editor" 


LICENSE = "GPLv3" 


LIC_FILES CHKSUM = "file://COPYING; md5=f27defele9 6c2elecd4e0c9be8967949" 


DEPENDS = "ncurses" 

BR =. p 

PV_MAJOR = "S{@bb.data.getVar('PV',d,1).split('.')[0]}\ 
.${@bb.data.getVar('PV',d,1).split('.') [1]}" 


SRC_URI = "http://www.nano-editor.org/dist/vs { PV_MAJOR}/nano-${PV}.tar.gz\ 
file://ncursesw.patch" 


SRC_URI[md5sum] = "af09f8828744b0ea0808d6c19a2b4bfd" 


inherit autotools gettext 
RDEPENDS _ S$S{PN} = "ncurses" 


前 面 的 菜谱 构建 GNU nanoia, CEBMLAtNRe. SAS (MMs SSRC URIMBAS, MHaVzeamLAtnRtenSske 
都 是 被 隐藏 在 autotools 类 中 的 。 


44.5 ”可 执行 元 数据 


茉 谱 、 妃 加 文件 和 类 可 以 包含 可 执行 元 数据 的 定义 。 可 执行 元 数据 是 BitBake 可 以 执行 的 shell 或 者 Python 函数 。 


BitBake 把 可 执行 元 数据 和 变量 等 同 对 待 : 阔 数 名 是 和 代表 被 赋予 的 值 的 立 数 代码 一 起 存储 在 数据 字典 中 的 。 结 果 就 是 ， 消 数 可 以 像 普 通 变 量 一 样 被 
追加 和 前 新 增 ， 并 且 可 能 有 元 数据 的 属性 。 


定义 在 菜谱 和 奶 加 文件 中 的 元 数据 浮 数 的 范围 是 本 地 于 特定 文件 的 ， 而 定义 在 类 中 的 函数 是 全 局 的 。 
shell BEX 
shell 函 数 被 定义 在 元 数据 文件 中 ， 正 如 你 会 在 普通 shell 脚 本 中 定义 它们 ( 见 程序 清单 4-6) 。 
程序 清单 4-6 ”可 执行 元 数据 shell 函 数 
helloworld () { 


echo "Hello, World!" 
} 


在 函数 体内 的 代码 遵循 普通 shell 的 语法 。 实 际 上 ，BitBake 在 执行 shell 函 数 时 调用 shell 的 解释 器 /bin/sh。 理 想 的 是 ， 所 有 shell 函 数 应 该 被 写成 无 关 
于 系统 默认 的 特殊 的 shell 解 释 器 。 在 所 有 由 Yocto 项 目 官方 支持 的 Linux 发 行 版 上 上， 默认 的 shell 解 释 器 是 Bourne Again Shell (bash) 。 为 了 使 你 自己 
的 代码 可 移植 ， 建 议 避 免 shell 特 定 的 扩展 并 且 遵 循 针 对 bash 衍 生 的 共同 特性 ， 例 如 .sh、.bash、.ksh 和 .zsh。 


Python RAŠ 
可 执行 元 数据 也 可 以 被 定义 为 Python 函数 ( 见 程序 清单 4-7) 。 


程序 清单 4-7” 可 执行 元 数据 Python 函数 


python printdate () { 


import time 
print time strftime('%Y%m%d', time.gettime() ) 


天 键 词 python 告 诉 BitBake 其 后 的 代码 被 解 析 成 Python 代码 。 


为 可 执行 元 数据 使 用 Python 使 得 你 能 导入 任何 Python 模块 并 且 利 用 许多 可 用 的 阔 数 。 在 函数 体内 ， 你 必须 注意 Python 针对 代码 段 的 缩 进 方案 。 建 
议 使 用 空格 替代 制 表 符 用 于 缩 进 。 


£E Python kk 


ARET LS Adef XAAR EEX, FERS CIURELEITAMIH, WER 4-8Arm. 


程序 清单 4-8 全 局 Python 国 数 


def machine_paths(d): 


"""Tist any existing machine specific filespath directories""" 
machine = d.getVar("MACHINE", True) 


filespathpkg = d.getVar("FILESPATHPKG", True).split(":") 
for basepath in d.getVar("FILESPATHBASE", True).split(":"): 
for pkgpath in filespathpkg: 


machinepath = os.path.join(basepath, pkgpath, machine) 
if os.path.isdir(machinepath) : 
yield machinepath 


语法 和 定义 任何 标准 Python 函 数 完全 相同 。 
因为 冰 数 是 全 局 的 ， 我 们 可 以 从 任何 其 他 Python 元 数据 图 数 中 调用 它 。 
= Pythonegax 
菜谱 、 妃 加 文件 和 类 可 能 使 用 _anonymous 天 键 词 作为 函数 名 字 或 者 一 起 省 略 阔 数 名 来 定义 匿名 Python 函数 ( 见 程序 清单 4-9) 。 
程序 清单 4-9 ”匿名 Python 函数 


python _ anonymous () { 
# Anonymous function using the __anonymous keyword 


} 
python () { 

# Anonymous function omitting the function name 
} 


SRR TCT EAS, BitBake TEZA. Pe, EMSS PE Betis CARAT ET. 


前 面 的 部 分 描述 了 如 何 定义 shell 和 Python 函数 作为 可 执行 元 
析 菜 谱 或 者 类 后 如 何 执行 芽 名 函数 。 


数据 。 问 题 是 ，BitBake 如 何 从 元 数据 文件 中 执行 国 数 ”我 们 已 经 看 到 BitBake 在 完成 解 
BitBake 把 特殊 函数 认 作 任务 。 任 务 是 被 定义 在 菜谱 和 类 中 的 ， 并 且 可 以 : 

. 针对 特殊 菜谱 直接 从 BitBake 命 令 行 调用 

. 被 BitBake 作 为 构建 过 程 的 部 分 而 自动 化 地 执行 


程序 清单 4-10 提 供 了 例子 。 


程序 清单 4-10 ”定义 任务 


python do_clean () { 
# task to clean remove build output 


} 


addtask clean 
do_build () { 
# task to build the software package 


} 
addtask build 
do_download () { 
# task to download sources 


} 
addtask download before do build 
do_unpack () { 

# task to unpack sources 


} 
addtask unpack before do_build after do_download 
do_compile () { 

# task to compile software package 


} 
addtask compile before do_build after do_unpack 
do_install () { 
# task to install binaries, libraries, and documentation 


} 
addtask install after do build 


为 了 将 shell 或 者 Python 消 数 定义 为 任务 ， 它 的 名 字 必 须 被 前 缀 以 do_。 除 了 这 个 ， 任 务 和 任何 其 他 可 执行 元 数据 完全 类 似 。 指 令 addtask 被 用 来 增 
加 任务 到 BitBake 任 务 列 表 和 定义 任务 执行 链 。 


在 程序 清单 4-10 中 的 代码 定义 了 任务 clean 并 且 用 addtask 将 其 增加 到 任务 列表 。 这 个 技术 允许 任务 可 以 从 BitBake 命 令 行 调用 。 让 我 们 假设 程序 清 
单 4-10 的 代码 被 放 在 名 为 myrecipe.bb 的 菜谱 中 。 使 用 


bitbake myrecipe -c clean 


调用 菜谱 的 clean 任 务 。 菜 谱 使 用 before 和 after 与 addtask 指 令 一 起 增加 任务 build、download、unpack、compile 和 install， 创 建 执 行 链 。 运 行 以 
下 命令 : 


bitbake myrecipe -c build 


首先 运行 download 任 务 是 unpack 任 务 ， 再 次 是 compile 任 务 ， 然 后 是 build， 以 及 最 后 是 install 任 务 。 
当 BitBake 被 以 菜谱 作为 参数 调用 但 没有 指定 要 运行 的 任务 时 ， 那 么 BitBake 运 行 默 认 任务 。 默 认 任 务 是 通过 变量 BB DEFAULT TASK 来 被 定义 的 。 
通过 base 类 设置 该 变量 为 : 


BB DEFAULT_TASK ?= "build" 


其 使 得 build 成 为 类 似 于 针对 makefiles 的 all 目 标的 默认 任务 。 菜 谱 和 类 当然 可 以 履 盖 BB_DEFAULT TASK 以 将 其 设置 为 不 同 的 任务 。 
Meee pipla]BitBakeSS 


BitBake 变 量 可 以 从 shell 和 Python 函数 中 被 访问 到 。 
从 shell 函 数 中 访问 变量 


从 shell 冰 数 内 ，BitBake 变 量 可 以 直接 通过 使 用 变量 扩展 表示 法 而 裤 访 问 ( 见 程序 清单 4-11) 。 


程序 清单 4-11 ”从 Shell 函 数 中 访问 变量 


BPN = "myapp-v1" 
MAKE = "make" 
EXTRA OEMAKE = "CFLAGS='-W -Wall -Werror -Wundef -Wshadow S${CFLAGS}'" 


do_compile () { 

bbnote ${MAKE} S{EXTRA_OEMAKE} "S@" 

${MAKE} ${EXTRA_OEMAKE} "$@" || die "oe_runmake failed" 
} 
do install () { 

BPN = "myapp" 

docdir = "docs" 


install -d ${D}${docdir}/${BPN} 


可 以 从 shell 函 数 中 读 取 变量 和 写 变 量 。 然 而 ， 写 变量 仅 仪 在 shell 脚 本 的 学 围 内 局 部 性 地 改变 它 的 值 。 在 程序 清单 4-11 中 ，BPN 是 在 do_install 中 被 
覆盖 的 BitBake 变 量 。 被 覆盖 的 值 仅仅 对 do_install 函 数 有 效 。 考 虑 到 BitBake 创 建 针对 do_install 函 数 的 带 有 所 有 变量 设置 和 扩展 的 shell 脚 本 并 且 执 行 该 
脚本 ， 那 个 惯例 是 容易 理解 的 。 


从 Python 函数 中 访问 变量 


从 Python 函数 中 访问 BitBake 比 从 shell 函 数 中 访问 稍微 复杂 一 点 儿 ， 因 为 BitBake 变 量 不 能 被 直接 读 取 或 者 写 而 是 必须 用 特殊 函数 从 BitBake 数 据 字 
典 中 获取 并 且 通 过 BitBake 数 据 字 典 操作 ( 见 程序 清单 4-12) 。 


程序 清单 4-12 ”从 Python 函数 访问 变量 


HELLO = "Hello, World!" 


DATE 二 wu 
python printhello () { 
hello = d.getVar('HELLO', True) 
print hello 
} 
python setdate () { 
import time 
date = time.strftime('%A %B %d, %Y', time.gettime() ) 
d.setVar('DATE', date) 
} 


为 数 getVar 和 setVar 通 过 BitBake 的 数据 字典 提供 对 变量 的 访问 ， 它 是 由 全 局 Python 变量 d 所 引用 的 。BitBake 的 数据 字典 是 作为 Python 类 实现 的 。 
国 数 getVar 和 setVar 是 该 类 的 方法 。 对 于 两 个 为数 的 第 一 个 参数 都 是 要 被 访问 的 变量 的 名 字 。 对 getVar 的 第 二 个 参数 是 告诉 函数 是 否 扩 展 变 量 表 达 式 的 
布尔 型 (Boolean) 值 。 对 setVar 的 第 二 个 参数 是 变量 的 新 值 。 


创建 本 地 的 数据 字典 副本 


使 用 setVar 和 全 局 数据 字典 全 局 性 地 修改 那个 变量 ， 并 且 为 所 有 后 续 的 操作 修改 了 它 的 值 。 如 果 不 需 要 ， 那 么 可 以 创建 数据 字典 的 副本 : 


localdata = d.createCopy () 


createCopy 方 法 创建 对 数据 字典 的 新 引用 。 因 为 BitBake 的 数据 字典 使 用 写 时 复制 ， 变 量 的 实际 副本 直到 写 操作 访问 时 才 被 创建 。 
访问 包含 值 列表 的 变量 
许多 BitBake 变 量 包 仿 值 是 由 分 隔 符 分 隔 的 值 列 表 。 通 常 ， 从 数据 字典 中 获取 出 来 后 ， 这 些 列表 变量 被 转化 成 Python 数 组 ( 见 程 序 清单 4-13) 。 


程序 清单 4-13 ”访问 变量 列表 


python do_download () { 
uris = (d.getVar('SRC_URI', True) or "").split(" ") 
for ùri in Uris: 
# process the source URIs 


程序 清单 4-13 的 样 例 代 码 从 数据 字典 中 获取 变量 SRC_URI， 它 是 空格 分 隔 的 URI 字 符 串 。 然 后 它 使 用 split 操 作 符 把 字符 串 拆 分 成 字符 串 数组 。 如 果 没 
有 在 数据 字典 中 找到 变量 SRC_URI， 那 么 术语 or”" 返 回 空 的 字符 串 以 使 代码 具有 故障 保护 能 


你 会 友 现 这 个 样 例 代 码 的 变 体 被 频繁 使 用 在 菜谱 和 类 中 以 获取 和 处 理 列表 。 


追加 和 前 新 增 函 数 
类 似 变量 ， 可 以 使 用 append 和 _prepend 操 作 符 追加 和 前 新 增 函 数 ( 见 程序 清单 4-14) 。 


程序 清单 4-14 EARI ATAR 


python printdate () { 
import time 
print time.strftime('%SA %B %d, %Y', time.gettime() ) 


} 


python printdate_prepend () { 
print ('Today is: ') 
} 


python printdate_append () { 
print('MOTD: A good day for the Yocto Project.') 


} 


在 程序 清单 4-14 中 的 代码 会 产生 组 合 的 printdate 消 数 〈 见 程序 清单 4-15) 。 


程序 清单 4-15 “组合 函数 
python printdate () { 
print ('Today is: ') 


import time 
print time strftime('%A %B %d, %Y', time.gettime() ) 
print('MOTD: A good day for the Yocto Project.') 


当然 ， 通 常 你 不 在 同一 个 文件 中 追加 和 前 新 增 函 数 。 追 加 和 前 新 增 的 典型 用 例 是 继承 类 和 增加 到 由 该 类 定义 的 函数 的 菜谱 或 者 是 扩展 由 其 追加 的 菜 
谱 定 义 的 浮 数 的 追加 文件 。 


二 


追加 和 前 新 增 可 用 于 shell 和 Python 函数 。 


4.4.6 “元 数据 属性 


所 有 BitBake 元 数据 (也 束 是 ， 变 量 以 及 函数 ) 可 以 有 属性 (attribute) ， 或 者 被 称 为 标识 (flag) 。 属 性 提供 标记 额外 信息 到 元 数据 的 方法 。 


BitBake 元 数据 语法 通过 将 括号 ([]) 中 的 属性 名 添加 到 变量 和 阔 数 名 来 提供 设置 属性 : 


VAR[flag] = "flagvalue" 


可 以 用 +=、=+、.= 和 =. 操 作 符 来 追加 和 前 新 增 属性 。 用 来 为 属性 赋值 的 表达 式 可 能 使 用 变量 扩展 。 然 而 ， 不 可 能 通过 BitBake 元 数据 语法 读 取 属 性 


的 值 。 
可 以 从 Python 函数 中 使 用 BitBake 数 据 字典 方法 getVarFlag 和 setVarFlag 来 读 取 和 写 属性 的 值 ( 见 程序 清单 4-16) 。 
程序 清单 4-16 “元 数据 属性 (标识 ) 
funo | ruin) = 1I" 
python func () { 
run = d.getVarFlag('func', 'run') 
IE yun == 
# do some work 
d.setVarFlag('func', 'run', 0) 


else: 
# do not run at this time 


方法 getVarFlag 的 第 一 个 参数 是 变量 的 名 字 ， 第 二 个 参数 是 标识 的 名 字 。setVarFlag 使 用 3 个 参数 : 变量 名 、 标 识 名 和 标识 值 。 


4.4.7 元 数据 名 ( 键 ) 扩展 


扩展 也 可 以 被 应 用 到 元 数据 名 。 实 际 的 扩展 友 生 在 数据 处 理 过 程 的 正 结尾 ， 崇 接 在 条 件 赋 值 、 妃 加 和 前 新 增 之 前 。 


AS{B} = "foo" 
B 一 NON 
AZ = "bar" 


变量 A2 包 含 foo， 因 为 表达 式 A${B}= "foo "的 完全 赋值 直到 表达 式 A2= "bar" 之 后 的 解析 过 程 的 结尾 才 被 判断 。 


45 JENE 


一 开始 便 有 源 ， 源 可 以 在 任何 地 方 以 任何 格式 呈现 。 因 此 ， 能 够 构建 由 数 百 个 软件 包 组 成 的 Linux 操 作 系统 栈 的 构建 系统 必须 要 能 从 大 量 源 获取 它 
们 ， 其 通常 被 称 为 上 游 仓 库 (upstream repositories) 。 上 游 仓库 可 以 是 本 地 的 或 者 是 远程 的 文件 服务 器 或 者 软件 配置 或 者 例如 Git、Subversion 等 的 
修订 控制 系统 。 可 以 例如 tar 的 包 形 式 打包 源 代 码 ， 且 通常 使 用 各 种 格式 压缩 这 些 包 。 当 使 用 源 代码 控制 管理 系统 (Source Control 
Management, SCM) 时 ， 通 常 以 源 树 的 形式 一 个 文件 一 个 文件 地 检 出 源 代码 。 


除了 提供 用 于 从 许多 不 同 源 获取 源 代码 包 的 必要 功能 性 ， 重 要 的 是 ， 构 建 系统 提供 一 致 和 透明 的 从 构建 荣 谱 访 问 仓库 而 不 要 求 最 终 用 户 了 解 仓库 与 
协议 实现 的 特性 的 方法 。 


BitBake 通 过 它 的 fetcher 架 构 提 供 了 必要 的 框架 。 在 BitBake 术 语 中 ， 获 取 是 取得 源 文 件 的 过 程 。 来 自 BitBake fetch2 库 (bitbake/lib/bb/fetch2) 
的 Python Fetch 类 通过 遵循 如 下 格式 的 源 URI 来 为 源 代码 获取 呈现 统一 的 接口 : 


<scheme>://[<user>[:<pwd>]@]<host>[:<port>]/<path>[;<key>=<value>;..] 


就 大 部 分 而 言 ，BitBake 获 取 器 (fetcher) URI 符 合 IETF 的 RFC3986 标 准 ， 除 了 路 径 的 处 理 以 外 。RFC3986 提 供 了 绝对 和 相对 路 径 。 参 考 标准 定义 
有 效 的 绝对 路 径 为 : 


file: //hostname/absolute/path/to/file 
file:///absolute/path/to/file 


BitBake 支 持 用 于 绝对 路 径 的 第 二 种 形式 ， 但 是 不 识别 第 一 种 形式 。 根 据 标准 ， 有 效 的 相对 路 径 可 以 被 指定 成 : 


file:relative/path/to/file 
BitBake 确 实 支持 使 用 那 种 格式 的 相对 路 径 ， 同 时 额外 识别 下 面 这 个 不 符合 RFC3986 的 格式 : 
file://relative/path/to/file 


这 个 格式 被 支持 是 为 了 带 有 获取 器 库 的 前 期 实现 的 向 后 兼容 性 以 避免 重 写 旧 的 菜谱 。 
BitBake URI 也 没有 由 IETF 标 准 提供 的 查询 (query) 和 片段 (fragment) 的 标记 。 


Fetch 基 类 延迟 URI 的 实际 处 理 和 访问 资源 到 特定 的 、 由 URI 的 方案 (scheme) 所 确定 的 实现 。 可 选 参数 列表 依赖 于 获取 器 的 特殊 实现 。 某 些 方案 可 
能 访问 需要 市 用 户 名 和 密码 的 身份 验证 的 资源 。 那 些 可 以 通过 使 用 标准 标记 而 被 包含 在 URI 中 。 


Fetch 基 类 的 重要 细节 是 ， 在 实例 化 中 ， 被 传 到 Fetch 基 类 的 源 URI 参 数 可 能 不 只 包含 单一 的 URI 而 是 以 前 面 形式 的 、 甚 至 可 能 使 用 不 同方 案 的 URI 列 
Ae 


4.5.1 ”使 用 Fetch 类 
虽然 BitBake 提 供 了 获取 器 架构 和 获取 器 实现 ， 但 是 它 不 提供 用 于 获取 源 文件 的 默认 任务 。 为 了 使 用 获取 器 ， 你 必须 要 在 菜谱 中 实现 任务 ， 或 者 更 倾 
向 于 在 BitBake 类 中 实现 它 。 程 序 清单 4-17 显 示 了 样 例 do fetch 任 务 的 实现 。 
程序 清单 4-17 样 例 do_fetch 任 务 
1 python do_fetch() { 


3 bb.note ("Downloading sources from ${SRC_URI} ...") 


4 

5 src_uri = (d.getVar('SRC_URI', True) or "").split() 
6 if len(src uri) == 0: 

7 bb. fatal ("Empty URI") 

8 

9 trv: 

10 fetcher = bb.fetch2.Fetch(src_uri, d) 

11 fetcher.download() 

12 except bb. fetch2.BBFetchException: 

13 bb. fatal("Could not fetch source tarball.") 
14 

15 bb.note ("Download successful.") 

16 } 

17 


18 addtask fetch before do_build 


样 例 任 务 的 第 5 行 首 先 从 BitBake 数 据 字典 中 获取 SRC_URI 变 量 。 这 个 变量 被 假设 成 包含 空格 分 隔 的 、 到 源 仓 库 的 URI 的 列表 。 人 列表 被 转化 成 Python 
列表 变量 (或 者 数组 ) 。 然 后 ， 第 10 行 从 Fetch 基 类 创建 了 fetcher 对 象 。 第 11 行 党 试 从 仓库 中 下 载 源 。 样 例 任务 的 其 他 代码 提供 用 于 调试 的 日 志 信 息 并 
且 处 理由 获取 器 导致 的 异常 。 

使 用 这 个 do _fetch 任 务 的 菜谱 将 仅仅 指定 SRC_URI 变 量 。 所 有 下 载 源 的 实际 工作 是 由 任务 和 获取 器 实现 来 处 理 的 。 事 实 上 ， 由 OpenEmbedded 核 
ity (OpenEmbedded Core) 元 数据 层 提供 的 base.bbclass 类 实现 了 非常 类 似 于 样 例 的 do_fetch 任 务 。 

这 留 下 了 样 例 任务 代码 没有 直接 回答 的 问题 : 获取 器 下 载 源 到 哪里 ”如 果 你 分 析 BitBake 获 取 器 库 的 代码 ， 那 么 你 会 注意 到 ， 获 取 器 期 望 变量 
DL_DIR 来 包含 它们 下 载 源 文件 所 到 的 目录 路 径 。 


4.5.3 ”镜像 


菜谱 设置 SRC_URI 变 量 为 源 代码 的 上 游 位 置 。 除 了 SRCI URI，BitBake 支 持 镜像 下 载 站 点 ， 从 那里 它 可 以 替代 性 地 获取 源 代码 包 。 
BitBake 使 用 已 定义 的 序列 来 访问 文件 位 置 和 站 点 : 


- BitBake 首 先 检查 由 DL_DIR 指 定 的 本 地 下 载 目录 ， 是 否 在 SRC_URI 中 提供 的 文件 已 经 被 下 载 了 。 如 果 已 经 被 下 载 了 ， 它 跳 过 访问 任何 上 游 和 镜像 站 
点 ， 并 且 使 用 在 DL_DIR 中 的 文件 。 如 果 一 些 文件 是 存在 的 ， 另 外 一 些 不 存在 ， 那 么 BitBake 增 量 地 下 载 文 件 。 如 果 SRC_URI 是 源 代 码 控 制 管 理 系统 ， 那 么 
它 验 证 在 DL_DIR 中 的 正确 分 支 和 标签 ， 并 且 根 据 需 要 最 终 更 新 它们 。 


. 如 果 在 SRC_URI 中 提供 的 文件 不 是 本 地 可 用 的 ， 那 么 BitBake 党 试 从 PREMIRRORS 变 量 指定 的 镜像 站 点 中 下 载 它 们 。 
. 如 果 前 镜像 站 点 不 提供 包 ， 那 么 BitBake 使 用 SRC_URI 从 上 游 项 目 站 点 直接 下 载 文件 。 
` 如 果 从 上 游 项 目 站 点 下 载 是 不 成 功 的 ， 那 么 BitBake 使 用 由 MIRRORS 变 量 提供 的 镜像 站 点 。 
. 如 果 下 载 站 点 都 没有 提供 需要 的 文件 ， 那 么 BitBake 抛 出 错误 消息 。 
使 用 镜像 和 前 面 的 序列 是 BitBake 的 默认 行为 。 如 果 你 不 想 使 用 镜像 ， 那 么 你 需要 将 PREMIRRORS 或 MIRRORS 变 量 或 两 者 都 设置 成 空 字符 串 。 


PREMIRRORS 和 MIRRORS 变 量 指定 用 于 键 匹 配 SRC_URI 的 正则 表达 式 和 指向 各 自 镜像 的 URI 组 成 的 元 组 列表 : 


MIRRORS = "\ 

网 http://downloads.mirrorsite.org/mirror/sources/ \n \ 
ACEO ff e fa" http://downloads.mirrorsite.org/mirror/sources/ \n \ 
https://.*/.* http://downloads.mirrorsite.org/mirror/sources/ \n \ 
ibs/ a a http://downloads.mirrorsite.org/mirror/sources/ \n \ 
Sys fas x http://downloads.mirrorsite.org/mirror/sources/ \n" 


元 组 的 键 和 URI 是 由 一 个 或 者 多 个 空格 字符 分 隅 的 ， 元 组 之 间 是 用 新 行 符 来 各 目 分 隅 的 。 通 剃 ， 镜 像 使 用 HTTP 协 议 用 于 文件 下 载 ， 但 是 其 他 文件 下 
载 协议 ， 例 如 FTP、HTTPS 和 SFTP 也 是 有 效 的 ， 只 要 BitBake 有 对 应 的 获取 器 。 


对 文件 下 载 的 操作 是 简单 直接 的 。 例 如 ， 如 果 BitBake 遇 到 使 用 FTP 方 案 的 SRC_URI， 那 么 它 会 寻找 企 MIRROR 变 量 中 的 匹配 键 ， 然 后 为 镜像 的 URI 
蔡 换 SRC_URI 方 案 和 路 径 。 使 用 上 面 的 镜像 列表 : 


SRC_URI = "ftp://ftp.site.org/downloads/file.tgz" 


有 效 地 转化 成 : 
SRC_URI = "http://downloads.mirrorsite.org/mirror/sources/file.tgz" 
然而 ， 如 果 镜 像 的 URI 指 向 下 载 站 点 ， 那 么 对 于 例如 Git 的 源 代码 控制 管理 系统 仓库 镜像 如 何 工作 ? 在 这 种 情况 下 ，BitBake 期 望 仓库 被 打包 成 tar 


包 。 它 从 镜像 下 载 tar 包 ， 并 且 本 地 解压 它 包 含 的 仓库 。 


Yocto 项 目 于 http://downloads.yoctoproject.org/mirror/sources 处 提供 了 在 高 可 用 性 基础 设施 上 的 源 镜 像 。 这 个 镜像 在 所 有 Yocto 项 目 构 建 环境 
中 均 由 Poky 参 考 发 行 版 策略 默认 局 用 。 


创建 镜像 


创建 你 自己 的 镜像 站 点 有 优点 ， 例 如 为 团队 最 小 化 网 络 访问 和 控制 产品 的 Linux 发 行 版 从 哪个 源 被 构建 。 你 可 以 通过 从 Yocto 项 目镜 像 下 载 所 有 源 包 
并 且 把 它们 放 在 一 台 内 部 网 络 服务 器 的 目录 中 来 创建 你 自己 的 镜像 站 点 。 你 也 可 以 从 Yocto 项 目 构 建 环境 的 下 载 目录 中 创建 镜像 ， 该 环境 用 于 构建 Linux 
上 帮 行 版 。 本 地 下 载 目录 已 包含 所 有 必要 源 ， 但 是 尚未 采用 适合 镜像 站 点 的 格式 。 黑 认 ， 并 且 为 了 节省 构建 时 间 ，BitBake 不 为 源 代码 控制 管理 系统 创建 源 
tar 包 。 你 可 以 通过 增加 如 下 内 容 到 conf/local.conf 文 件 来 命令 BitBake 在 本 地 下 载 目录 中 创建 tar 包 : 


BB GENERATE MTRROR_TARBALLS = "1" 


在 构建 已 经 成 功 完成 后 ， 简 单 地 复制 所 有 在 下 载 目 录 中 的 文件 到 镜像 服务 器 。 你 必须 复制 文件 。 你 不 能 使 用 到 文件 的 符号 链接 ， 因 为 获取 器 不 跟随 


符号 链接 。 


在 镜像 服务 器 被 设置 后 ， 你 可 以 使 用 它 的 URI 用 于 MIRRORS 和 PREMIRRORS 变 量 。 


4.6 HelloWorld 一 一 BitBake 方 式 


前 面 的 章节 解释 了 BitBake 要 素 并 且 为 使 用 BitBake 作 为 构建 系统 莫 定 了 基础 。 现 在 是 时 候 用 简单 的 例子 来 说 明 问 题 了 一 一 BitBake 的 HelloWorld。 
这 可 能 不 是 你 可 以 用 BitBake 处 理 的 最 原生 的 例子 ， 但 是 它 示 例 了 如 何 使 用 它 来 给 作为 目标 的 构建 主机 构建 开源 软件 包 。 


这 个 例子 从 源 构建 nano 文 本 编辑 器 (http://nano-editor.org) 。nano 使 用 GNU Autotools 用 于 配置 。 为 了 这 个 工作 在 构建 主机 上 的 例子 ， 你 需 
要 安装 包含 Autotools 的 GNU 开 发 包 。 你 当然 也 需要 BitBake。 


首先 ， 我 们 需要 为 我 们 的 BitBake HelloWorld 项 目 设 置 构建 环境 。 程 序 清单 4-18 显 示 了 它 的 布局 。 


程序 清单 4-18 BitBake HelloWorld 构 建 环境 布局 


yocto@yocto-dev:~/bitbakes tree -L 3 bbhello 
bbhello/ 


-— classes 
| L— base.bbclass 
| 一 conf 
| -— bblayers.conf 
| L— bitbake.conf 
L— meta-hello 
| 一 conf 
| -一 layer.conf 
L— recipes-editor 
L— nano 


我 们 简单 地 从 BitBake 安 半 目 录 复 制 BitBake 的 默认 文件 base.bbclass 和 bitbake.conf 到 构建 环境 。 融 本 例 而 言 ， 它 们 包含 所 有 需要 的 设置 。 
文件 bblayers.conf 设 置 构建 环境 并 且 也 包含 我 们 的 meta-hello 层 ， 它 最 终 包 含 用 于 构建 nano 编 辑 器 的 菜谱 ( 见 程序 清单 4-19) 。 
程序 清单 4-19 bblayers.conf 


# Initialize BBPATH with the top-level directory of the 
# build environment. 


BBPATH := "S{TOPDIR}" 
# Initialize BBFILES to an empty string as it is set up 


# by the layer.conf files of the layers. 
BBFILES ?= "" 


# Add our layer to BBLAYERS. 
BBLAYERS = " \ 


S{TOPDIR}/meta-hello \ 


" 


文件 首先 设置 BBPATH 变 量 为 构建 环境 的 顶级 目录 并 且 初 始 化 BBFILES 为 空 字符 串 。 然 后 ， 它 增加 meta-hello 层 到 BBLAYERS。 为 了 简化 性 ， 这 个 例 
子 是 全 部 自 包含 的 ， 并 且 在 构建 内 包含 meta-hello。 


正如 前 面 简 要 列 出 的 ， 所 有 BitBake 层 都 必须 包含 layer.conf 配 置 文件 ， 它 被 显示 在 程序 清单 4-20 中 。 


程序 清单 4-20 layer.conf 


# Add the path of this layer to BBPATH 
BBPATH .= ":S{LAYERDIR}" 
# Add recipes and append files to BBFILES 
BBFILES += "S{LAYERDIR}/recipes-*/*/*.bb \ 
$ {LAYERDIR}/recipes-*/*/*.bbappend" 


# Set layer search pattern and priority 
BBFILE COLLECTIONS += "hello" 

BBFILE PATTERN test := "*S${LAYERDIR}/" 
BBFILE PRIORITY test = "5" 


这 个 文件 本 质 上 是 样板 文件 模板 的 副本 。 仅 有 的 必要 调整 是 搜索 模式 和 优先 级 设置 。 


最 后 ， 我 们 需要 菜谱 来 构建 nano 编 辑 器 。 我 们 把 这 个 菜谱 放 进 层 的 顶级 目录 meta-hello 的 子 目 录 recipes-editor 中 。 到 我 们 层 的 菜谱 的 完整 路 径 匹 
配 在 layer.conf 中 BBFILES 内 的 表达 式 。 程 序 清单 4-21 显 示 了 菜谱 。 


程序 清单 4-21 nano.bb 


SUMMARY = "Recipe to build the 'nano' editor" 


PN = "nano" 
PY a "2 2.6" 


SITE = "http://www.nano-editor.org/dist" 
PY MAJOR = "${@bb.data.getVar('PV',d,1).split('.')[0]}" 
PY MINOR = "S${@bb.data.getVar('PV',d,1).split('.')[1]}" 


SRC_URI = "S${SITE}/v${PV_MAJOR}.${PV_MINOR}/S${PN}-S${PV}.tar.gz" 
SRC_URI[md5sum] = "03233ae480689a008eb98 feb1b599807" 
SRC_URI[sha256sum] = 和 
"be68e133b5e81d£41873d32c517b3e5950770c00Fc5£4dd23810cd635abce67a" 


python do_fetch() { 
bb.plain("Downloading source tarball from ${SRC_URI} ...") 
are: uri = (d.getVar( "SRC URL’, True} or "")..epbve() 
it len{sre uri) == 
bb. fatal ("Empty URI") 
Gry’ 
fetcher = bb.fetch2.Fetch(src_uri, d) 
fetcher.download() 
except bb.fetch2.BBFetchException: 
bb.fatal("Could not fetch source tarball.") 
bb.plain("Download successful.") 


} 


addtask fetch before do build 


python do_unpack() { 
bb.plain("Unpacking source tarball ...") 
os.system("tar x -C ${WORKDIR} -f ${DL_DIR}/S${P}.tar.gz") 
bb.plain("Unpacked source tarball.") 

} 


addtask unpack before do_build after do_fetch 


python do_configure() { 
bb.plain("Configuring source package ...") 
os.system("cd S${WORKDIR}/S${P} && ./configure") 
bb.plain("Configured source package.") 


} 
addtask configure before do_build after do_unpack 


python do_compile() { 
bb.plain("Compiling package...") 
os.system("cd S{WORKDIR}/S{P} && make") 
bb.plain("Compiled package.") 

} 


addtask compile before do_build after do_configure 


do_clean[nostamp] = "1" 
do_clean() { 
rm -rf S{WORKDIR}/S${P} 
rm -f S{TMPDIR}/stamps/* 
} 


addtask clean 


这 个 菜谱 使 用 了 很 多 BitBake 元 数据 语法 的 主要 概念 : 变量 设置 、 变 量 扩展 、Python 变 量 扩展 、 变 量 属 性 、 从 Python 代码 中 访问 BitBake 变 量 、 
Python 任务 、shell 任 务 等 。 


为 了 构建 nano 文 本 编辑 器 ， 从 构建 环境 的 顶级 目录 中 简单 的 执行 


S bitbake nano 


如 果 所 有 东西 工作 正常 ， 那 么 你 应 该 看 到 类 似 于 程序 清单 4-22 的 输出 。 
程序 清单 4-22 构建 Nano 文 本 编辑 器 


S bitbake nano 
NOTE: Not using a cache. Set CACHE = <directory> to enable. 
Parsing recipes: 100% |#######H#FFHEFEEFEFEEEEEEEEFEEE HEHEHE | Time: 00:00:00 
Parsing of 1 .bb files complete (0 cached, 1 parsed). 1 targets, 
0 skipped, 0 masked, 0 errors. 
NOTE: Resolving any missing task queue dependencies 
NOTE: Preparing runqueue 
NOTE: Executing RunQueue Tasks 
Downloading source tarball from 
http: //www.nano-editor.org/dist/v2.2/nano-2.2.6.tar.gz 
Download successful. 
Unpacking source tarball 
Unpacked source tarball. 
Configuring source package ... 
Configured source package. 
Compiling package... 
Compiled package. 
NOTE: Tasks Summary: Attempted 5 tasks of which 0 didn't need to be rerun and all 
succeeded. 


nano 可 执行 程序 位 于 你 可 以 运行 它 的 tmp/work/nano-2.2.6-r0/nano-2.2.6/src 中 。 


你 可 以 用 如 下 命令 清理 构建 环境 : 
S bitbake nano -c clean 


当然 ， 这 是 非常 简单 的 例子 。 构 建 系统 ,例如 OpenEmbedded 构 建 系统 ， 构 建 完全 的 Linux 操 作 系统 栈 ， 必 须 提供 更 多 功能 性 并 且 包 含 数 百 个 菜谱 
和 很 多 类 。 另 外 ，OpenEmbedded 构 建 系统 能 够 针对 不 同 染 构 和 许多 不 同 机 器 类 型 来 进行 构建 ， 也 为 它们 构建 必要 的 交叉 工具 链 。 


47 ”依赖 处 理 


构建 系统 极 少 只 构建 单一 的 软件 包 。 如 果 多 个 软件 包 被 构建 ， 那 么 依赖 通常 存在 于 那些 包 中 的 一 些 之 间 ， 意 味 着 构建 系统 必须 能 够 处 理 这 样 的 依 
赖 。 构 建 系 统 必须 能 够 检测 所 有 对 包 做 出 的 变更 ， 重 新 执行 任何 因 变 更 而 失效 的 任务 ， 然 后 也 重新 执行 任何 来 自 于 依赖 变更 包 的 一 个 或 者 多 个 任务 输出 
的 软件 包 的 任务 。 


构建 系统 通常 区 分 2 种 类 型 的 依赖 : 
. 构建 依赖 : 对 成 功 构 建 的 软件 包 来 说 所 需要 的 组 件 。 这 些 可 以 是 头 文 件 、 静 态 库 或 其 他 组 件 。 
. 运行 时 依赖 : 对 软件 包 正 常 操 作 所 需要 的 组 件 。 这 些 可 以 是 库 、 配 置 文件 或 其 他 组 件 。 


为 了 表达 依赖 ， 构 建 系统 必须 实现 一 种 让 软件 包 声 明 它 们 的 名 字 或 者 功能 性 的 方法 ， 以 及 一 种 让 其 他 软件 包 将 那个 名 字 或 者 功能 性 引用 为 依赖 的 万 
法 。 


4.7.1 MS 


用 于 软件 包 的 BitBake 菜 谱 使 用 PROVIDES 变 量 来 声明 它们 的 名 字 和 功能 性 ， 然 后 其 他 菜谱 可 以 用 其 来 表达 它们 对 那个 软件 包 的 依赖 。BitBake 给 出 
了 3 种 不 同 的 配置 的 变 体 ， 在 本 书 中 ， 它 们 被 称 为 隐 式 配置 、 显 式 配置 和 符号 配置 。 


隐 式 配置 


Fe 


BitBake}\ RERIN FERRA FAE, ERR AMOEBA. CRRA ECS, PRECIEREHAB Gb, We RSS AT 
解释 的 。 


BitBake 文 件 名 遵循 下 面 的 惯例 : 
<package name>_<package version>_<package revision>.bb 
惯例 用 下 划 线 (_) 连接 包 名 、 包 版 本 和 包 修 订 ; 例如 ， 


nano _ 2.260 70-400 


BitBake 解 析 文 件 名 并 且 对 应 地 设置 变量 PN、PV 和 PR: 


PN = "nano" 
PV = "2.2.0" 
PR = ~y" 


如 果菜 谱 名 不 提供 包 修 订 ， 那 么 PR 默认 成 r0。 如 果 它 不 提供 包 版 本 ， 那 么 PV 默认 成 1.0。 当 然 ， 在 通过 菜谱 名 使 用 隐 式 配置 时 ， 你 不 能 指定 包 修 订 
而 不 指定 包 版 本 。 如 果 你 想 提 供 包 修订 而 不 指定 包 版 本 ， 那 么 你 必须 使 用 显 式 配置 。 然 而 ， 这 样 做 通 剃 没有 多 大 意义 ， 因 为 包 修 订 仪 仅 在 包 版 本 的 上 下 
文中 才 有 意义 。 


通过 赋值 


PROVIDES _prepend = "S${PN} " 


包 和 总 是 声明 它 的 包 名 。 
显 陈 配置 


3 个 变量 PN、PV 和 PR 可 以 由 菜谱 自己 通过 对 它们 赋值 来 显 式 地 设置 。 这 样 的 显 式 配 置 覆 盖 任 何 从 文件 名 中 获取 到 的 设置 。BitBake 对 应 地 设置 
PROVIDES 变 量 。 


符号 配置 


菜谱 也 可 以 覆 医 或 者 添加 a 到 可 用 于 指定 该 包 的 符号 名 字 的 PROVIDES 变 量 。 然 后 依赖 于 它 的 包 可 以 引用 符号 名 字 。 如 果 多 个 包 或 者 同一 个 包 的 多 个 
版 本 提供 相同 的 功能 性 ， 那 么 这 是 有 意义 的 : 


PROVIDES =+ "virtual/editor" 


这 个 用 在 菜谱 中 针对 nano 文 本 编辑 器 的 声明 将 增加 符号 名 字 virtual/editor 到 名 字 列 表 。 增 加 符号 名 字 到 PROVIDES 而 不 是 全 部 覆盖 变量 是 一 直 被 推 
存 的 。 符 号 名 字 实 际 上 做 什么 不 重要 ， 但 是 为 了 避免 符号 名 字 和 实际 其 他 菜谱 名 字 的 无 意 冲 突 ， 开 妈 者 已 经 采用 惯例 来 使 用 前 缀 virtual/ 用 于 符号 


M I, 


明显 的 是 ， 如 果 多 个 包 使 用 相同 的 符号 名 字 ， 那 么 构建 系统 必须 有 一 种 方法 来 决定 使 用 哪个 菜谱 。 我 们 会 在 4.7.3 节 解决 这 个 间 


Éi 
o 


[因为 符号 名 字 中 前 斜 杠 的 使 用 ， 很 明显 在 Linux 构 建 主机 上 ， 符 号 名 字 永 远 不 会 与 实际 菜谱 中 的 名 字 发 生 冲突 ， 因 为 在 UNIX 系 统 上 ， 前 斜 杠 是 用 来 分 


隔 路 径 段 的 。 


Proxy Error 


The proxy server received an invalid response from an upstream server. 
The proxy server could not handle the request GET /resource/readBook. 


Reason: Error reading from remote server 


4.1.3 ”多 个 提供 器 


通过 符号 配置 ， 多 个 包 可 能 满足 其 另 一 个 包 的 构建 或 运行 时 依赖 。 例 如 ， 可 能 有 两 个 包 提供 用 于 一 个 电子 邮件 程序 的 文本 编辑 器 功能 。 电 子 邮件 程 
序 本 身 不 关心 这 两 个 文本 编辑 器 的 哪 一 个 提供 这 个 功能 性 ， 只 要 其 中 一 个 是 可 用 的 束 行 : 


editorl.bb: PROVLDES: = "virtual /editor" 
editor2.bb: PROVIDES = "virtual/editor'" 
mailer.bb: RDEPENDS = "virtual/editor" 


这 两 个 编辑 器 包 都 提供 邮件 包 所 需要 的 virtual/editor 功 能 性 。BitBake 如 何 选 择 两 个 编辑 器 包 的 其 中 之 一 来 构建 ?通过 PREFERRED_PROVIDER 变 
量 ， 你 可 以 选择 BitBake 构 建 的 提供 virtual/editor 的 包 : 


PREFERRED_PROVIDER virtual/editor = "editor2" 


最 弟 见 的 是 ， 这 个 变量 被 放 进 配置 文件 中 ， 例 如 友 行 版 策略 配置 文件 。 


2 | SSB 


许多 元 数据 层 包 含 多 个 菜谱 以 构建 相同 软件 包 的 不 同 版 本 。 例 如 OpenEmbedded 核 心 元 数据 层 提供 多 个 菜谱 来 构建 Linux 内 核 的 不 同 版 本 。 


默认 情况 下 ，BitBake 总 是 


选择 构建 包 的 最 新 版 本 的 菜谱 ， 正 如 PV 变量 所 指示 的 。 然 而 ， 你 可 以 通过 指定 PREFERRED_VERSION 变 量 来 覆盖 默认 行 
为 : 


PREFERRED_VERSION_editor = "1.1" 


你 必须 根据 实际 包 名 来 设置 这 个 变量 。 有 时 ， 版 本 号 是 由 额外 信息 所 追加 的 ， 例 如 Git 标 等 或 者 一 个 次 版 本 号 。 在 这 个 情况 下 ， 你 通过 向 版 本 字符 串 
增加 百 分 号 (%) 来 告诉 BitBake， 额 外 的 信息 是 不 相关 的 : 


PREFERRED_VERSION_linux-yocto = "3.10%" 


菜谱 可 能 设置 DEFAULT PREFERENCE 变 量 来 指示 比 它 版 本 号 更 低 或 者 更 高 的 优先 级 : 


editor_1.1.bb: DEFAULT PREFERENCE = "6" 
editor_1.2.bb: DEFAULT_PREFERENCE = "0" 


默认 情况 下 ，BitBake 将 选择 editor-1.2.bb 菜 谱 而 不 是 editor-1.1.bb 菜 谱 ， 因 为 它 是 更 新 的 版 本 。 然 后 ， 通 过 使 用 DEFAULT_PREFERENCE， 构建 
旧版 本 的 菜谱 的 优先 级 被 提高 。 对 于 DEFAULT_PREFERENCE 的 默认 值 是 5。 


推荐 你 仅仅 对 实验 性 的 构建 更 新 版 本 的 菜谱 使 用 DEFAULT_PREFERENCE 来 降低 它们 的 优先 级 : 


editor_2.0.bb: DEFAULT_PREFERENCE = "-1" 


如 果 你 不 知道 菜谱 正在 使 用 它 ， 那 么 使 用 DEFAULT_PREFERENCE 除 了 降低 实验 性 菜谱 的 优先 级 外 还 很 容易 导致 不 恨 结果 和 混乱 。 


49 变 体 


菜谱 通常 构建 用 于 目标 系统 的 软件 包 的 变 体 。 然 而 ， 对 于 一 些 包 ， 变 体 是 不 同 应 用 所 需要 的 。 上 典型 的 例子 是 在 一 个 目标 变 体 和 一 个 原生 或 者 主机 变 
体 上 所 需要 的 编译 器 。 为 了 从 相同 的 菜谱 局 用 一 个 包 的 多 个 变 体 ，BitBake 提 供 了 BBCLASSEXTEND 变 量 : 


BBCLASSEXTEND += "native" 


如 果 这 个 指令 被 用 在 一 个 菜谱 中 ， 那 么 它 命令 BitBake 除 了 为 目标 变 体 也 为 构建 主机 构建 软件 包 的 一 个 原生 变 体 。 在 这 种 功能 性 背后 的 机 制 
是 ，BitBake 又 一 次 执行 继承 native 类 的 菜谱 。 为 了 使 这 种 机 制 正 确 工作 ， 你 必须 在 一 个 叫 作 native.bbclass 的 文件 中 定义 natvie 类 。 


BBCLASSEXTEND 包 含 一 个 由 空格 分 隔 的 列表 ， 人 允许 你 用 不 同 的 类 来 按照 需要 多 次 执行 菜谱 。 


基于 正在 构建 的 变 体 ， 在 一 个 菜谱 中 包含 的 变量 或 者 任务 可 能 需要 包含 不 同 的 值 或 者 执行 不 同 的 处 理 步骤 。 这 可 以 通过 条 件 地 履 兰 变量 或 者 任务 来 
实现 。 使 用 以 下 命令 : 


VARIABLE class-target = "target value" 
VARIABLE class-native 


nat we valic’ 


依赖 于 BitBake 正 在 构建 的 变 体 而 赋予 VARIABLE 不 同 的 值 。 所 有 不 使 用 变 体 覆 苹 的 变量 和 任务 是 由 所 有 变 体 所 共享 的 。 


变 体 target 是 隐 式 的 。 也 没有 类 target 被 定义 。 所 有 用 在 BBCLASSEXTEND 中 的 其 他 类 都 必须 被 它们 各 自 的 .bbclass 文 件 所 定义 。 


4.10 “默认 元 数据 


BitBake 定 义 、 使 用 和 依赖 于 一 些 上 默认 元 数据 对 象 。 你 会 友 现 它们 在 许多 菜谱 和 类 中 被 引用 。 在 接 下 来 的 部 分 ,我们 讨论 这 个 核心 的 变量 和 任务 列 
表 。 


当然 ，OpenEmbedded、Poky 和 和 其 他 元 数据 层 随 着 它们 扩展 BitBake 的 功能 性 而 增加 更 多 的 元 数据 。 当 谈 到 在 第 7 章 中 构建 一 个 定制 化 Linux 友 行 版 
的 上 下 文 、 在 第 8 章 中 开发 用 于 软件 包 的 菜谱 、 在 第 9 章 中 配置 和 编译 Linux 内 核 、 在 第 10 章 中 开发 板 支 持 包 的 时 候 ， 我 们 讨论 许多 这 些 扩展 及 其 元 数据 并 
且 介 绍 它们 。 


410.1 变量 


BitBake 引 用 和 使 用 数 个 变量 。 它 期 望 设置 那些 变量 ， 否 则 它 会 引发 一 个 错误 并 且 终止 执行 。BitBake 从 它 当前 的 上 下 文中 内 部 地 获取 这 些 变量 中 的 
一 些 ， 并 且 对 应 地 设置 它们 。 其 他 则 被 bitbake.conf 文 件 设置 成 默认 值 。 对 一 个 第 3 类 来 说， 你 必须 显 式 地 为 项 目 提供 设置 。 


内 部 获取 的 变量 


BitBake 从 它 当 前 的 上 下 文中 获取 针对 以 下 变量 的 值 ， 并 且 对 应 地 设置 它们 : 


by 


路 


- FILE: 到 BitBake 正 在 处 理 的 文件 的 完整 路 径 。 文 件 可 以 是 一 个 配置 文件 、 一 个 菜谱 、 一 个 类 等 。 
- LAYERDIR: 当 BitBake 处 理 那 一 层 时 ， 它 把 这 个 变量 设置 为 到 当前 层 的 目录 的 完整 路 径 。 


- TOPDIR: BitBake 设 置 这 个 变量 为 到 你 已 经 执行 了 BitBake 的 所 在 目录 的 完整 路 径 。BitBake 期 望 你 要 么 从 构建 环境 的 顶级 目录 运行 它 ， 要 么 显 式 地 
设置 这 个 变量 为 你 构建 环境 的 顶级 目录 ， 正 如 前 面 所 显示 的 。 


项 目 特定 的 变量 
这 些 变量 是 特定 于 BitBake 项 目的 。 你 需要 显 式 地 为 项 目 设 置 它们 。 
- BBFILES: 空格 分 隔 的 针对 菜谱 的 路 径 列表 。 用 于 一 个 层 的 layet.conf 配 置 文件 扩展 这 个 变量 以 增加 它 自 己 的 菜谱 。 
- BBLAYERS: 当 BitBake 处 理 那 一 层 时 ， 它 把 这 个 变量 设置 为 到 当前 层 的 目录 的 完整 路 径 。 


- BBPATH: BitBake 使 用 这 个 变量 在 一 个 名 为 classes 的 子 目 录 中 定位 类 (.bbclass 文 件 ) 、 在 一 个 名 为 conf 的 子 目录 中 定位 配置 文件 (.conf 文 件 ) 以 及 


R 
在 其 他 子 目 录 中 定位 文件 。 变 量 包含 一 个 由 冒号 C) 分 隔 的 目录 路 径 列表 。 层 通常 增加 它们 的 顶级 目录 到 这 个 变量 : BBPATH.=": ${LAYERDIR}". 


标准 运行 时 变量 


标准 运行 时 变量 被 很 多 BitBake 模 块 所 引用 。 因 此 ， 它 们 必须 包含 有 效 的 值 以 使 BitBake 正 确 运 行 。 这 些 变 量 通 党 被 conf/bitbake.conf 文 件 初始 化 。 
BitBake 源 包 提 供 了 一 个 包含 默认 设置 的 conf/bitbake.conf 文 件 。 如 果 你 从 头 开始 启动 一 个 BitBake 项 目 ， 正 如 我 们 对 HelloWorld 项 目 所 做 的 ， 你 可 以 
使 用 这 个 文件 作为 起 始点 。 


OpenEmbedded 核 心 元 数据 层 ， 它 形成 Poky 构 建 系 统 的 基础 ， 包 含 一 个 初始 化 更 大 的 变量 列表 的 conf/bitbake.conf 文 件 来 满足 包含 在 那个 层 中 的 
众多 类 的 要 求 。 随 着 我 们 在 接 下 来 的 章节 中 探索 更 多 Poky 的 功能 性 ， 我 们 将 在 它们 适合 的 上 下 文中 介绍 这 些 变量 。 


-B: 到 BitBake 构 建 一 个 源 包 所 在 的 目录 的 完整 路 径 。 通 常 BitBake 解 压 源 包 所 到 的 是 相同 目录 : B=${S}。 对 于 树 外 构建 ，B 可 以 被 设置 成 指向 一 个 不 
同 的 构建 目录 。 


- BUILD ARCH: 构建 主机 的 CPU 和 架构 。 在 大 部 分 情况 下 ， 自 动 使 用 BUILD-ARCH=${(@os.uname0[4]} 来 获取 值 ， 在 Linux 系 统 上 它 返 回 系 统 的 架构 。 


-CACHE: 到 用 于 元 数据 缓存 的 目录 的 完整 路 径 ， 它 通常 存在 于 构建 环境 的 内 部 : CACHE=${fTOPDIR}/cache。 当 BitBake 在 一 个 构建 环境 中 第 一 次 
被 运行 时 ， 它 解析 所 有 元 数据 文件 和 菜谱 并 且 创 建 一 个 在 后 续 运 行 时 从 那里 读 取 的 缓存 。 这 改进 了 执行 速度 。 一 个 元 数据 变化 使 缓存 失效 并 且 导 和 致 
BitBake 重 新 创建 它 。 


-CVSDIR: 到 BitBake 检 出 CVS 仓 库 所 在 目录 的 完整 路 径 。 对 于 这 个 目录 默认 是 下 载 目录 的 一 个 子 目 录 : CVSDIR=${DL_DIR}/cvs. 


D: 到 一 个 任务 (例如 一 个 安装 任务 或 者 一 个 镜像 创建 任务 ) 放置 其 输出 的 所 在 目录 的 完整 路 径 。 例 如 ， 一 个 使 用 make install 的 安装 任务 引用 这 个 


. DEPENDS: 这 个 变量 用 一 个 空格 分 隔 的 包 名 来 描述 包 依 赖 性 。 


- DEPLOY DIR: 到 BitBake 放 置 所 有 用 于 部 署 的 文件 所 在 的 基础 目录 的 完整 路 径 ， 例 如 目标 镜像 、 包 源 和 许可 程序 清单 (license manifest) o RAIA 


况 下 ， 这 个 目录 存在 于 构建 环境 中 : DEPLOY_DIR=${TMPDIR} /deploy. 


- DEPLOY DIR IMAGE: 到 BitBake 复 制 目标 二 进 制 镜 像 所 在 目录 的 完整 路 径 。 它 典型 地 指向 DEPLOY_DIR: 


DEPLOY_DIR_IMAGE=${DEPLOY_DIR}/images 的 一 个 子 目 录 。 


- DL DIR: 到 下 载 目录 的 完整 路 径 。 默 认 设 置 把 这 个 目录 放 在 构建 环境 中 : DL DIR=${TMPDIR}/downloads。 为 了 避免 多 次 下 载 相 同 的 源 文件 和 当 
工作 于 不 止 一 个 构建 环境 时 的 时 间 和 硬盘 空间 的 消耗 ， 建 议 设 置 变量 为 构建 环境 外 的 路 径 。 


- FILE DIRNAME: 到 包含 BitBake 正 在 处 理 的 文件 的 目录 的 路 径 。 自 动 使 用 FILE_DIRNAME=${@os.path.difrname(bb.data.getVat(EFILE7))} 来 获取 值 。 


- FILESDIR: 到 BitBake 寻 找 本 地 文件 所 在 目录 的 完整 路 径 。BitBake 仅 仅 当 它 不 能 在 任何 列 于 FILESPATH 中 的 目录 中 找到 文件 时 使 用 这 个 变量 。 对 这 


个 变量 的 最 常见 的 用 例 在 追加 文件 中 。 


-FILE>PATH: 这 个 变量 包含 一 个 冒号 分 隔 的 、BitBake 的 本 地 获取 器 为 了 匹配 本 地 文件 所 搜索 的 完整 目录 路 径 列表 。 默 认 设置 是 


FILESPATH="${FILE_DIRNAME}/${PF} : ${FILE_DIRNAME}/${P} : ${FILE_DIRNAME}/${PN} : ${FILE_DIRNAMBE}/files : ${FILE_DIRNAME}", 
-GITDIR: 到 BitBake 检 出 Git 仓 库 所 在 目录 的 完整 路 径 。 对 于 这 个 目录 默认 是 下 载 目录 的 一 个 子 目 录 : GITDIR=${DL_DIR} /git. 
MKTEMPCMD: BitBake 用 来 创建 临时 文件 的 命令 : MKTMPCOMMAND="mktemp-q${TMPBASE}"。 
: MKTEMPDIRCMD: BitBake 用 来 创建 临时 目录 的 命令 : MKTMPCOMMAND="mktemp-d-q${TMPBASE}Y"。 
-OVERRIDES: 冒号 分 隔 的 条 件 履 盖 的 优先 级 列表 。BitBake 从 右 到 左 处 理 这 个 列表 ， 所 以 后 面 列 出 的 有 更 高 优先 级 。 
P: 用 横 线 (-) 连接 的 包 名 、 版 本 : P="${PN}-${PV}"。 


. PERSISTENT DIR: 到 BitBake 持 久 存 储 文件 所 在 目录 的 完整 路 径 。 默 认 设 置 是 PERSISTENT_DIR="${TOPDIR} /cache"。CACHE 和 


PERSISTENT_DIR 交 量 可 以 互 换 使 用 。 其 中 之 一 必须 被 设置 。 如 果 PERSISTENT_DIR 没 有 被 设置 ，BitBake 退 回 使 用 CACHE。 
PF: ARR C) 连接 的 包 名 、 版 本 和 修订 : PF="${PN}-${PV}-${PR}"。 
PN: 从 菜谱 文件 名 获取 的 包 名 。 
PR: 从 菜谱 名 获取 的 或 者 显 式 设 置 的 包 修订 。 
- PROVIDES: 空格 分 隔 的 、 声 明 一 个 包 提 供 了 什么 的 名 字 列 表 。 其 他 菜谱 可 以 使 用 这 些 名 字 来 声明 它们 对 这 个 包 的 依赖 。 
PV: 从 菜谱 文件 名 获取 的 或 者 显 式 设 置 的 包 版 本 。 
- S: 到 BitBake 放 置 已 解压 文件 所 在 目录 的 完整 路 径 。 默 认 情 况 下 ， 对 于 包 来 说 这 是 一 个 工作 目录 的 子 目 录 : S="${WORKDIR}/${P}". 
-SRC_URI: 为 源 包 下 载 URI。 
- SRCREV: 用 于 从 源 代 码 控 制 管理 系统 下 载 所 用 的 源 修订 。 
. SVNDIR: 到 BitBake 检 出 Subvetsion 仓 库 所 在 目录 的 完整 路 径 。 对 于 这 个 目录 默认 是 下 载 目录 的 一 个 子 目录 : SVNDIR=${DL_DIR}/svn. 


T: 到 一 个 BitBake 处 理 一 个 包 菜 谱 时 存储 临时 文件 (例如 任务 代码 和 任务 日 志 ) 的 所 在 目录 的 完整 路 径 。 软 认 情 况 下 ， 这 个 目录 存在 于 包 的 工作 目 


RP: T="${WORKDIRY /tmp". 
- TARGET ARCH: 针对 BitBake 正 在 构建 的 CPU 架构 。 


- TMPBASE: 到 一 个 BitBake 使 用 MKETMPCMD 和 MKTEMPDIRCMD 命 令 来 创建 临时 文件 和 目录 的 所 在 目录 的 完整 路 径 。BitBake 模 块 、 类 和 任务 根 


据 它们 的 需求 而 设置 这 个 变量 。 


-TMPDIR: 到 BitBake 放 置 所 有 构建 输出 (例如 包 构 建 、 根 文件 系统 阶段 、 镜 像 和 和 包 源 ) 的 顶级 目录 的 完整 路 径 。 它 通常 存在 于 构建 环境 内 部 : 


TMPDIR="${TOPDIR} /tmp"。 对 于 这 个 变量 名 字 的 选择 和 它 的 默认 设置 有 点 不 那么 幸运 。 虽 然 从 BitBake 总 是 可 以 重建 它们 的 角度 来 说 ， 在 TMPDIR 内 的 
文件 和 目录 是 临时 的 ， 但 是 目录 包含 所 有 构建 输出 和 制品 。 这 使 得 目录 实际 上 比 它 的 名 字 所 上 暗示 的 更 加 重要 。 


-WORKDIR: 到 BitBake 构 建 一 个 包 并 且 存 储 所 有 与 包 的 构建 过 程 相关 的 日 志 信 息 的 目录 的 路 径 。 默 认 设 置 是 
WORKDIR="${TMPDIR} /work/${PF}". 


正如 你 所 看 到 的 ， 许 多 变量 引用 其 他 变量 ， 特 别 是 针对 文件 和 目录 的 路 径 。 这 创建 了 一 个 使 你 能 够 通过 仅仅 改变 在 一 个 配置 文件 的 变量 来 简单 定制 
构建 环境 的 非常 灵活 的 架构 。 


410.2 ”任务 

BitBake 代 码 也 包含 一 个 由 base.bbclass 提 供 的 base 类 的 默认 实现 。 你 可 以 使 用 这 个 类 作为 你 自己 的 基于 BitBake 的 构建 系统 的 起 点 。 当 
然 ， OpenEmbedded 核 心 元 数据 层 提供 了 一 个 扩展 的 base 类 。 

BitBake 的 默认 base.bbclass 提 供 以 下 的 任务 : 


. build: 这 是 BitBake 在 执行 菜谱 时 的 默认 任务 ， 除 非 另 一 个 任务 是 通过 变量 BB_DEFAUIT_CLASS 的 。 默 认 base 类 不 实际 实现 任何 有 用 的 用 于 执行 
的 东西 。 你 需要 在 菜谱 中 禾 盖 它 或 使 用 它 作为 另 一 个 任务 的 锚 点 ， 正 如 我 们 在 HelloWotrld 例 子 中 所 做 的 。 


-listtasks: 带 有 任何 目标 执行 这 个 任务 显示 所 有 可 适用 于 目标 的 任务 。 其 中 包含 目标 的 菜谱 所 定义 的 任务 以 及 菜谱 从 类 中 所 继承 的 任何 任务 。 注 
意 ， 任 务必 须 以 它们 任务 散 列 值 的 顺序 列 出 ， 并 不 是 按照 字母 排序 或 者 以 它们 的 执行 为 顺序 。 


4.11 总 结 


IONS 


一 


这 一 章 展 元 了 BitBake 的 概览 一 一 OpenEmbedded 和 Poky 背 后 的 构建 引 | 掌 


- BitBake 是 由 OpenEmbedded 和 Yocto 项 目 作 为 OpenEmbedded 构 建 系统 的 核心 组 件 而 联合 开发 的 ， 被 2 个 项 目 共享 。Yocto 项 目的 Poky 参 考 发 行 版 发 布 
包含 针对 特定 发 布 、 匹 配 Poky 元 数据 的 BitBake 版 本 。 


. BitBake 要 求 执行 或 者 构建 环境 伴随 特定 元 数据 变量 被 正确 地 设置 。Poky 包 含 shell 脚 本 来 正确 设置 和 初始 化 构建 环境 。 


` BitBake 元 数据 区 分 变量 和 可 执行 元 数据 或 者 函数 。 元 数据 函数 可 以 作为 shell 或 者 Python 代码 来 实现 。 任 务 是 特别 声明 的 、 被 BitBake 作 为 目标 的 构 
建 过 程 的 一 部 分 执行 的 元 数据 函数 ， 或 者 是 可 以 被 显 式 地 从 BitBake 命 令 行 调用 的 元 数据 函数 


元 数据 被 组 织 成 配置 文件 、 菜 谱 、 类 、 追 加 文件 和 包含 文件 。 
BitBake 的 元 数据 语法 提供 各 种 表达 式 以 操作 变量 内 容 。 变 量 可 能 包含 单一 值 或 者 由 分 隔 符 所 分 隔 的 值 的 列表 。 
- 条 件 变 量 赋值 以 及 变量 追加 和 前 新 增 允 许 基 于 上 下 文 来 履 盖 变量 。OVERRIDES 变 量 包 含 条 件 的 优先 级 列表 。 
- 作为 shell 代 码 实 现 的 元 数据 函数 可 以 直接 访问 元 数据 变量 ， 而 Python 函数 需要 通过 BitB 东 ke 数据 字典 来 访问 它们 。 
- 来 自 Python 元 数据 函数 的 返回 值 可 以 直接 被 赋予 元 数据 变 
- BitBake 的 依赖 处 理 允 许 在 包 级 别 声明 依赖 。 为 了 优化 并 行 执 行 ，BitBake 强 制 在 任务 级 别 的 依赖 性 。 
- 用 于 包 的 符号 名 允许 包 基 于 提供 的 功能 性 而 不 是 实现 包 的 名 字 来 申明 依赖 性 。 变 量 PREFERRED_PROVIDER 允 许 选 择 实现 的 包 。 
` 包 可 能 提供 多 个 菜谱 以 构建 包 的 不 同 版 本 。BitBake 总 是 构建 带 有 最 高 版 本 的 最 新 包 ， 除 非 不 同 的 版 本 是 通过 PREFERRED_VERSION 指 定 的。 


. 变 体 或 者 类 扩展 提供 一 种 用 于 针对 不 同 应 用 (例如 目标 和 构建 主机 ) 多 次 构建 相同 包 的 机 制 ， 而 不 用 重 写 整个 菜谱 。 


412 参考 文献 


BitBake 的 源 包 包含 可 以 被 格式 化 成 HTML 或 者 PDF 输出 的 DocBook 格 式 的 文档 。 在 线 文档 位 于 www.yoctoproject.org/docs/2.0/bitbake-user- 


manual/bitbake-user-manual.html, 


第 5 章 ”故障 排除 


作为 软件 开 上 友 者 ， 你 应 当 非 囊 清 楚 ， 不 是 “万 一 ”而 是 “ 何 时 ”会 在 构建 软件 中 出 问题 这 一 疑问 非 党 重要。 复杂 构建 系统 的 故障 排除 可 能 是 使 人 晨 
缩 的 任务 。 失 败 可 能 源 自 构建 系统 的 很 多 不 同方 面 : 在 菜谱 中 和 类 中 的 代码 、 配 置 文件 设置 、 交 叉 开 友 、 要 构建 的 软件 包 、 打 包 等 。 其 大 体 归 结 为 : 


:定位 和 识别 失败 的 原因 
- 寻找 和 应 用 解决 方案 


手头 上 有 恰当 的 工具 并 且 知 道 如 何 有 效 地 使 用 它们 ， 这 可 为 正确 地 定位 和 识别 问题 的 根本 原因 (root cause) 节省 大 量 时 间 和 努力 。 
OpenEmbedded 构 建 系统 提供 了 一 组 帮助 你 寻找 导致 构建 失败 的 问题 的 工具 。 然 而 ， 寻 找 针对 问题 的 解决 方案 ， 可 能 是 具有 挑战 性 的 。 由 于 潜在 的 大 量 
问题 及 其 起 源 ， 对 于 如 何 解决 构建 问题 没有 单一 和 简单 的 回答 。 问 题解 决 需要 许多 天 于 识别 问题 模式 以 及 修改 和 应 用 类 似 问 题 的 解决 方案 的 经 验 。 我 们 
不 阻止 你 进行 问题 解决 ， 但 是 鼓励 你 设置 符合 现实 的 预期 。 依 赖 于 你 的 软件 开 上 友 经 验 ， 你 能 相当 轻松 地 找到 对 一 些 问 题 的 解决 方案 ， 而 其 他 则 代表 着 更 
大 的 挑战 。 然 而 ， 有 可 能 你 不 是 唯一 经 历 特定 问题 的 人 。 互 联网 及 其 搜索 引擎 使 软件 开 友 者 可 非常 轻松 地 找到 对 几乎 所 有 间 题 的 解决 方案 。 


接 下 来 的 部 分 解释 由 OpenEmbedded 构 建 系统 提供 的 各 种 调试 工具 以 及 如 何 使 用 它们 。 


51 WHS 


BitBake 记 录 发 生 在 构建 过 程 中 的 所 有 事件 。 所 记录 的 事件 是 
` 插入 到 可 执行 元 数据 中 的 调试 语句 

: 来 自由 任务 和 其 他 代码 执行 的 任何 命令 的 输出 

- 由 任务 和 其 他 代码 执行 的 任何 命令 所 发 出 的 错误 消息 


所 有 日 志 消 息 被 路 由 到 各 种 日 志文 件 ， 从 这 些 文件 中 ， 它 们 可 以 被 获取 。BitBake 为 它 所 执行 的 每 个 任务 以 及 它 自 己 的 主 构建 过 程 创 建 日 志文 件 。 任 
何 由 BitBake 任 务 和 其 他 代码 执行 的 命令 友 送 到 stdout 和 和 stderr 的 全 部 输出 都 被 重 定向 到 日 志文 件 。 在 正常 操作 中 ，BitBake 不 显示 在 执行 时 的 任何 日 志 
输出 ， 除 非 有 警告 或 者 错误 条 件 。 


5.1.1 日 志文 件 


BitBake 为 它 的 所 有 进程 维护 独立 的 日 志文 件 。 其 中 包含 它 的 cooker 进 程 ， 它 是 主 构建 进程 ， 也 是 对 每 个 菜谱 的 每 个 任务 来 说 的 主 进程 。cooker 进 
程 为 它 所 运行 的 每 个 任务 派生 独立 进程 。 


通用 日 志文 件 


BitBake 将 所 有 通用 日 志文 件 (例如 cooker 的 look 文 件 ) 存储 在 由 LOG_DIR 变 量 指向 的 目录 中 。 默 认 情 况 下 ， 这 个 目录 是 用 于 临时 构建 文件 的 目录 
中 的 名 为 log 的 子 目 录 : 


LOG_DIR = "${TMPDIR}/log" 


在 那个 目录 中 ， 你 为 每 个 BitBake 进 程 (例如 cooker) 找到 子 目录 。 日 志文 件 由 目标 机 器 进一步 划分 。 例 如 ， 如 果 你 正在 为 qemux86 机 器 构建 系 
统 ， 那 么 cooker 子 目录 包含 谷 有 实际 日 志文 件 的 qemux86 子 目录 。 里 然 这 个 设置 需要 一 些 努 力 来 从 目录 树 中 导航 ， 但 是 它 更 容易 使 你 找到 相关 日 志 
件 。 


BitBake 在 进程 启动 时 使 用 时 间 截 来 命名 日 志文 件 ， 这 有 效 地 维护 了 日 志文 件 的 历史 。 拥 有 日 志文 件 的 历史 以 及 从 后 续 构 建 中 互相 比较 文件 可 以 帮助 
你 有 效 地 追 中 构建 失败 。BitBake 总 是 为 其 时 间 堆 使 用 协调 世界 时 (Coordinated Universal Time, UTC) 而 不 是 使 用 本 地 时 间 ， 这 使 得 它们 在 使 用 不 同 
时 区 的 远程 构建 服务 器 时 是 容易 比较 的 。 


cooker 日 志文 件 包含 所 有 BitBake 在 运行 时 也 写 到 控制 台 的 日 志 输 出 。 程 序 清单 5-1 显 示 仪 仪 针 对 来 自 了 预先 构 建 的 包 中 的 镜像 的 简短 cooker 日 志 
件 。 


程序 清单 5-1 cooker 日 志文 件 


NOTE: Resolving any missing task queue dependencies 


Build Configuration: 


BB_VERSION Ss LL, 2" 

BUILD_SYS = "x86_64-linux" 
NATIVELSBSTRING = "Fedora-18" 

TARGET_SYS = "31586-poky-linux" 
MACHINE = "gemux86" 

DISTRO = "Doky" 

DISTRO_VERSION = "1.5+snapshot-20140210" 
TUNE_FEATURES = 92 1586" 

TARGET FPU = "" 

meta 

meta-yocto 

meta-yocto-bsp = "master: 095bb006c3dbbfbdfa05f13d8d7b50e2a5ab2af0" 


NOTE: Preparing runqueue 
NOTE: Executing SetScene Tasks 


NOTE: Executing RunQueue Tasks 

NOTE: Running noexec task 2051 of 2914 (ID: 4, /develop/yocto/yocto-git/poky/meta/ 
recipes-core/images/core-image-minimal.bb, do_fetch) 

NOTE: Running noexec task 2052 of 2914 (ID: 0, /develop/yocto/yocto-git/poky/meta/ 
recipes-core/images/core-image-minimal.bb, do_unpack) 

NOTE: Running noexec task 2053 of 2914 (ID: 1, /develop/yocto/yocto-git/poky/meta/ 
recipes-core/images/core-image-minimal.bb, do_patch) 

NOTE: Running noexec task 2910 of 2914 (ID: 9, /develop/yocto/yocto-git/poky/meta/ 
recipes-core/images/core-image-minimal.bb, do_package_write) 

NOTE: Running task 2911 of 2914 (ID: 8, develop/yocto/yocto-git/poky/meta/recipes- 
core/images/core-image-minimal.bb, do_populate_lic) 

NOTE: Running task 2912 of 2914 (ID: 7, develop/yocto/yocto-git/poky/meta/recipes- 
core/images/core-image-minimal.bb, do_rootfs) 

NOTE: recipe core-image-minimal-1.0-r0: task do_populate_lic: Started 

NOTE: recipe core-image-minimal-1.0-r0: task do_populate_lic: Succeeded 

NOTE: recipe core-image-minimal-1.0-r0: task do_rootfs: Started 

NOTE: recipe core-image-minimal-1.0-r0: task do_rootfs: Succeeded 

NOTE: Running noexec task 2914 of 2914 (ID: 12, /develop/yocto/yocto-git/poky/ 
meta/recipes-core/images/core-image-minimal.bb, do_build) 

NOTE: Tasks Summary: Attempted 2914 tasks of which 2907 didn't need to be rerun 
and all succeeded. 


cooker 日 志文 件 中 的 一 条 重要 信息 是 构建 配置 ， 它 告诉 你 这 个 构建 使 用 什么 设置 。 这 个 信息 在 调试 “ 它 昨 天 工作 ， 为 什么 今天 不 工作 了 ? ”这 类 问 
题 时 非常 有 价值 。 常 见地 ， 配 置 中 的 变化 可 能 导致 构建 失败 ， 比 较 成 功 构建 的 cooker 日 志文 件 和 失败 构建 的 cooker 日 志文 件 可 帮助 你 追踪 问题 。 下 面 的 
变量 组 成 了 列 在 cooker 日 志文 件 开头 的 构建 配置 : 


- BB VERSION: BitBake 版 本 号 。BitBake 和 元 数据 层 一 起 演化 。 使 用 元 数据 层 的 更 新 版 本 ， 例 如 OpenEmbedded 核 心 和 更 老 的 BitBake 版 本 ， 可 能 导 
致 问题 。 这 就 是 Poky 把 核心 元 数据 层 和 BitBake 一 起 打包 的 原因 之 一 。 然 而 ，BitBake 向 后 兼容 ， 使 得 你 可 以 使 用 更 新 的 版 本 和 更 老 的 元 数据 层 。 


- BUILD SYS: #4### ARM KA. HE" AUVILD_SYS="${BUILD_ARCH}${BUILD_VENDOR}-${BUILD_OS} "4k Æ SU bitbake.conf F - 


BUILD_ARCH @ #4uname-m#y #7 8 , BUILD_OS @& 4uname-s 69 H H , BUILD_VENDOR 是 通常 为 空 的 定制 字符 串 。 
- NATIVELSBSTRING: 用 破 折 号 连接 的 发 行者 ID 和 发 布 号 码 ， 正 如 用 命令 lsb_telease 获 取 的 。 


- TARGET SYS: 目标 系统 的 类 型 。 这 个 变量 作为 TARGET_SYS="${TARGET_ARCHIY${TARGET_VENDOR}${@[- 


'+d.getVar (TARGET_OSvTrue) ,"|[d.getVar ('TARGET_OS' True) == ("oricustom') ]}" 被 定义 在 bitbake.conf 中 。 
- MACHINE: BitBake 正 在 为 其 构建 的 目标 机 器 。 
‘DISTRO: 目标 发 行 版 的 名 字 。 
- DISTRO VERSION: 目标 发 行 版 的 版 本 。 
- TUNE FEATURES: 针对 目标 CPU 架构 的 优化 参数 。 
- TARGET _FPU: 用 于 目标 架构 的 浮 点 单元 的 身份 识别 。 
- meta[-XXXX]: 用 于 元 数据 层 (如 果 它 们 是 从 Git 仓 库 中 检 出 的 ) 的 分 支 和 提交 ID。 


对 于 程序 清单 5-1 中 的 例子 ， 在 使 用 x86 上 的 64 位 架构 的 Fedora18 构 建 主机 上 ， 作 者 已 经 使 用 了 从 Yocto 项 目的 Git 仓 库 中 检 出 的 Poky。 目 标 系统 是 
使 用 Poky 友 行 版 策略 为 REMU 构 建 的 32 位 Linux 系 统 。 


任务 日 志文 件 


BitBake 为 它 所 运行 的 每 个 菜谱 的 每 个 任务 创建 日 志文 件 。 上 默认 情况 下 ，BitBake 在 T 变 量 指向 的 目录 中 存储 任务 日 志文 件 。 上 默认 情况 下 ， 这 个 目录 是 
荣 谱 工作 目录 的 子 目 录 : 


T = "S${WORKDIR}/temp" 


这 对 除了 清理 工作 目录 的 clean 任 务 以 外 的 所 有 任务 都 适用 。 因 为 运行 clean 任 务 最 终 也 删除 工作 目录 和 它 的 子 目录 ， 所 以 对 于 clean 任 务 ，T 变 量 被 
有 条 件 地 设置 成 : 


T task-clean = "${LOGDIR}/cleanlogs/${PN}" 


日 志文 件 被 存储 到 根据 其 执行 菜谱 的 包 名 命名 的 子 目 录 中 。 


用 于 任务 的 日 志文 件 被 命名 为 log.do_<taskname>.<pid> ， 其 中 pid 是 任务 被 BitBake 运 行 时 的 进程 ID。 进 程 ID 用 于 区 分 多 次 执行 的 相同 任务 的 任 
务 日 志 。 这 使 得 比较 场景 前 和 场景 后 以 及 比较 成 功 的 任务 执行 和 失败 的 执行 是 简单 直接 的 。 更 大 的 任务 号 码 通常 意味 着 更 多 的 当前 运行 。 名 字 为 
log.do_<taskname> 的 符号 连接 指向 包含 最 当前 运行 的 日 志 输 出 的 日 志文 件 。 


除非 在 元 数据 文件 中 有 不 正确 的 语法 ， 人 否则 几乎 所 有 构建 失败 都 与 菜谱 任务 的 执行 有 关 。 当 定位 针对 失败 任务 的 日 志文 件 时 ， 通 过 打印 它 的 完整 路 
径 和 错误 消息 到 控制 台 ，BitBake 提 供 了 大 量 帮助 。 程 序 清单 5-2 显 示 了 用 于 构建 nano 文 本 编辑 器 的 菜谱 当前 失败 的 任务 。 


程序 清单 5-2 ”任务 失败 


NOTE: Resolving any missing task queue dependencies 


Build Configuration: 


BB_ VERSION SS Lak 

BUILD_SYS = "x86 _64-linux" 
NATIVELSBSTRING = "Fedora-18" 

TARGET_SYS = "1586-poky-linux" 
MACHINE = "gemux86" 

DISTRO = "poky" 

DISTRO_VERSION = "1.5+snapshot-20140211" 
TUNE_FEATURES = "m32 1586" 

TARGET FPU = "" 

meta-mylayer = "<unknown>:<unknown>" 
meta 

meta-yocto 

meta-yocto-bsp = "master: 095bb006c3dbbfbdfa05f13d8d7b50e2a5ab2af0" 


NOTE: Preparing runqueue 

NOTE: Executing SetScene Tasks 

NOTE: Executing RunQueue Tasks 

ERROR: This autoconf log indicates errors, it looked at host include and/or 
library paths while determining system capabilities. 

Rerun configure task after fixing this. The path was 
'/develop/yocto/yocto-git/x86/tmp/work/i586-poky-linux/nano/2.3.1-r0/nano-2.3.1' 
ERROR: Function failed: do_ga_configure 

ERROR: Logfile of failure stored in: 


.../tmp/work/i586-poky-linux/nano/2.3.1-r0/temp/log.do_configure.17865 

ERROR: Task 5 (.../meta-mylayer/recipes-apps/nano/nano_2.3.1.bb, 

do_configure) failed with exit code '1' 

NOTE: Tasks Summary: Attempted 550 tasks of which 545 didn't need to be rerun and 
1 failed. 

No currently running tasks (550 of 558) 

Summary: 1 task failed: 


.../meta-mylayer/recipes-apps/nano/nano_2.3.1.bb, do_configure 
Summary: There were 3 ERROR messages shown, returning a non-zero exit code. 


以 ERROR 开 头 的 行 包 含 构建 失败 的 相关 信息 ， 例 如 所 向 问题 根本 原因 的 线索 、 失 败 的 任务 以 及 到 日 志文 件 的 完整 路 径 。 你 可 以 简单 地 使 用 日 志文 件 
的 路 径 人 在 你 喜欢 的 编辑 器 中 查看 任务 失败 原因 的 额外 信息 。 即 使 你 清除 控制 人 台 或 者 天 闭 它 的 窗口 ， 你 仍然 可 以 稍 后 从 cooker 日 志文 件 中 获取 这 个 输出 。 


5.1.2 ”使 用 记 日 志 语 名 

一 个 若 不 是 最 常用 到 的 ， 那 就 是 更 常用 到 的 ， 用 于 在 编程 中 调试 的 方法 是 向 代码 中 插入 允许 遵循 执行 路 径 和 通过 打印 变量 内 容 来 检查 数据 的 调试 消 
息 。 

BitBake 提 供 多 个 级 别 来 指示 消息 的 严重 性 : 

. Plain (普通 ) : 完全 按照 传递 的 方式 记录 消息 而 不 带 任何 额外 信息 。 


-Debug (调试 ) : 记录 前 级 了 DEBUG: 的 消息 。 记 日 志 功 能 也 期 望 在 1 和 3 之 间 指 示 调 试 级 别 的 数字 型 参数 。 然 而 ， 只 有 对 于 Python 函数 ， 调 试 级 别 
才 被 实际 求 值 。 对 于 shell 涵 数 ， 所 有 消息 都 被 记录 而 不 管 调试 级 别 。 


. Note (注意 ) : 记录 前 级 了 NOTE: 的 消息 。 它 被 用 来 通知 用 户 需 要 知道 的 条 件 或 者 信息 。 
-Warn (警告 ) : 记录 前 级 了 WARNING: 的 消息 。 警 告 指示 最 终 应 该 被 用 户 关注 的 问题 ， 然 而 ， 它 们 不 导致 构建 失败 。 
. Error (错误 ) : 记录 前 级 了 ERROR: 的 消息 。 错 误 指 示 需 要 被 解决 以 成 功 完 成 构建 。 然 而 ， 构 建 可 以 继续 直到 没有 需要 构建 的 任务 。 


- Fatal (致命 ) : 记录 前 组 了 FATAL: 的 消息 。 致 命 条 件 使 得 BitBake 在 消息 已 经 被 记录 后 立即 终止 构建 过 程 。 


依赖 于 上 下 文 ， 所 有 消息 被 写 入 到 各 自 的 日 志文 件 中 。 注 意 ， 和 敬告、 错误 和 致命 消息 页 被 输出 到 控制 人 台 。 调 试 消息 仪 仅 当 BitBake 的 调试 级 别 等 于 或 
者 高 于 消息 的 级 别 时 才 被 写 到 控制 台 。BitBake 的 调试 级 别 是 通过 增加 -D 参 数 到 BitBake 的 命令 行 来 设置 的 。 


bitbake -D <target> 
bitbake -DD <target> 
bitbake -DDD <target> 


分 别 选 择 调试 级 别 1、2 或 者 3。 普 通 消 息 永 远 不 被 写 到 控制 台 。 


志 消 息 可 以 被 插入 到 定义 在 文 持 可 执行 元 数据 的 文件 中 的 任何 函数 : ite, 菜谱 、 追 加 文件 和 类 。 对 Python 和 shell 可 执行 元 数据 来 说 ， 提 供 了 
匹配 日 志 级 别 的 记 日 志 消 数 ( 见 表 5-1) 。 


Val ix bbdebug level message 
Beth bbfatal message 


Python 函数 作为 BitBake 库 的 一 部 分 实现 。 你 可 以 在 文件 bitbake/lib/bb/_init_.py 中 找到 实现 。BitBake 的 Python 记 日 志 使 用 了 和 扩展 了 Python 
的 记 日 志 的 类 。 文 件 bitbakeylib/bby/msg.py 为 日 志 消息 提供 格式 化 和 过 滤 类 。 特 别 是 ， 类 BBLogFormatter 提 供用 于 不 同 消息 级 别 的 色彩 化 。 如 果 色 彩 
化 被 启用 ， 那 么 警告 消息 以 黄色 显示 ， 错 误 和 致命 消息 以 红色 打印 。 


shell 遂 数 是 由 logging.bbclass 实 现 的 ，logging.bbclass 是 由 OpenEmbedded 核 心 元 数据 层 提供 的 。 
在 程序 清单 5-3 和 5-4 中 的 伪 代 码 说 明了 对 于 Python 和 shell 可 执行 元 数据 的 记 日 志 功 能 的 使 用 。 
程序 清单 5-3 Python 记 日 志 例 子 


python do_something() { 

bb.debug(2, "Starting to do something...") 
if special_condition: 

bb.note("Met special condition.") 
bb.debug(2, "Processing input") 
if warning_condition: 

bb.warn("Upper limit out of bounds, adjusting to maximum.") 
if error_condition: 

bb.error("Recoverable error, proceeding, but needs to be fixed.") 
if fatal_condition: 

bb.fatal("Division by 0, unable to proceed, exiting.") 
bb.plain("The result of doing something is ‘mostly nothing'.") 
bb.debug(2, "Done with doing something.") 


程序 清单 5-4 ”shell 记 日 志 例 子 


do_something() { 
bbdebug 2 "Starting to do something..." 
if [ special_condition ]; then 
bbnote "Met special condition." 


fi 
bbdebug 2 "Processing input" 
if [ warning_condition ]; then 
bbwarn "Upper limit out of bounds, adjusting to maximum." 
fi 
if [ error_condition ]; then 
bberror "Recoverable error, proceeding, but needs to be fixed." 
fi 
if [ fatal _condition ]; then 
bbfatal "Division by 0, unable to proceed, exiting." 
fi 


bbplain "The result of doing something is 'mostly nothing'." 


bb.debug 2 "Done with doing something." 


ARE OHSS AAA PACA AS eT RATER. FETE RSMAS Ral. farms Sis AAA SWZ eA 


恰当 的 级 别 。 通 党 ， 你 不 应 该 使 用 致命 级 别 而 应 奉 代 性 地 使 用 错误 级 别 ， 它 给 了 BitBake 完 成 并 
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í 
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J 运行 


的 其 他 任务 的 处 理 、 清 理 和 使 构建 环境 处 在 一 致 状 


态 的 机 会 。 使 用 致命 级 别 会 导致 BtBakeY 即 终止 执行 ， 它 可 能 使 得 构建 环境 处 于 BitBake 无 法 在 后 续 执 行 时 目 动 恢复 的 状态 。 


5.2 ”任务 执行 


Ft 


对 于 任何 给 定 的 菜谱 ，BitBake 以 由 依赖 性 定义 的 特殊 序列 执行 一 系列 任务 ， 对 菜谱 使 用 命令 listtasks 会 得 到 你 为 该 菜谱 定义 的 所 有 任务 的 列表 ( 见 


程序 清单 5-5) 。 


程序 清单 5-5 ”该 列 出 用 于 菜谱 的 任务 


=e 


user@buildhost:~$ bitbake busybox -c listtasks 
[... omitted for brevity ...] 


NOTE: Preparing runqueue 
NOTE: Executing RunQueue Tasks 


do_build Default task for a recipe - depends on all 
other normal tasks required to 'build' a 
recipe 

do_checkuri Validates the SRC_URI value 

do_checkuriall Validates the SRC_URI value for all recipes 
required to build a target 

do_clean Removes all output files for a target 

do_cleanall Removes all output files, shared state 
cache, and downloaded source files for a 
target 

do_cleansstate Removes all output files and shared state 
cache for a target 

do_compile Compiles the source in the compilation 
directory 

do_compile_ptest_base Compiles the runtime test suite included in 
the software being built 

do_configure Configures the source by enabling and 


disabling any build-time and configuration 
options for the software being built 


do_configure_ptest_base Configures the runtime test suite included 
in the software being built 
do_devshell Starts a shell with the environment set up 


for development /debugging 


lass Omitted Tor Dreit raal 


输出 是 以 字母 顺序 列 出 所 有 任务 ， 并 简要 说 明 每 项 任务 的 功能 。 然 而 ， 它 不 提供 关于 在 一 般 构建 过 程 中 什么 任务 被 运行 以 及 以 何 种 顺序 运行 的 信 


正如 我 们 在 第 3 章 中 所 看 到 的 ， 对 任何 软件 包 的 构建 很 大 程度 上 遵循 下 面 这 些 标 准 步骤 : 

获取 : 从 下 载 站 点 或 者 克隆 源 仓库 获取 包 源 代码 包 ， 以 及 所 有 可 应 用 的 补丁 和 其 他 本 地 文件 。 
解压 : 从 包 中 解压 源 代码 、 补 丁 和 其 他 文件 。 

` 打 补丁 : 应 用 补丁 。 

ACE: 在 目标 环境 中 为 构建 准备 资源 。 

` 构建 : 编译 源 ， 归 档 对 象 进入 库 ， 以 及 将 对 象 链接 进 可 执行 程序 。 

ZS: 复制 二 进 制 和 辅助 文件 到 它们 在 模拟 的 系统 环境 中 的 目标 目录 中 。 

` 打包 : 根据 被 选择 的 包 管理 系 统 创 建安 装 包 ， 包 括 任何 程序 清单 。 


你 可 以 通过 分 析 由 在 OpenEmbedded 核 心 元 数据 层 中 的 类 创建 的 任务 依赖 性 来 亲 循 构建 链 ， 方 法 是 在 类 文件 中 搜索 关键 字 addtask: 


S grep addtask *.bbclass 


使 用 输出 ， 你 可 以 判定 任务 依赖 性 〈 见 程序 清单 ?-6) 。 


程序 清单 5-6 任务 依赖 性 


base.bbclass: addtask fetch 


base. bbclass: addtask unpack after do_fetch 

patch.bbclass: addtask patch after do_unpack 

base. bbclass: addtask configure after do_patch 

license.bbclass: addtask populate_lic after do_patch before do_build 
base.bbclass: addtask compile after do_configure 

base.bbclass: addtask install after do_compile 

staging.bbclass: addtask populate_sysroot after do_install 
package.bbclass: addtask package before do_build after do_install 


package_deb.bbclass: addtask package_write_deb before do_package_write 
after do_packagedata do_package 

package_ipk.bbclass: addtask package_write_ipk before do_package_write 
after do_packagedata do_package 


package_rpm.bbclass: addtask package_write_rpm before do_package_write 
after do_packagedata do_package 

package.bbclass: addtask package_write before do_build 
after do_package 

base. bbclass: addtask build after do_populate_sysroot 


对 于 程序 清单 5-6， 我 们 使 用 了 应 用 到 上 典型 用 户 空间 软件 包 的 任务 。 例 如 内 核 的 特殊 包 使 用 不 同 的 过 程 。 我 们 也 按照 执行 序列 排序 了 列表 并 且 省 略 了 
对 于 典型 的 包 构建 过 程 来 说 不 相关 的 任务 。 


5.2.1 执行 特定 任务 
对 给 定 的 菜谱 单独 执行 任务 和 在 连续 执行 之 间 做 出 调整 ， 这 在 调试 构建 失败 时 可 能 是 非常 有 帮助 的 。 
使 用 


S bitbake <target> -c <task> 


为 给 定 的 <target> 荣 谱 执 行 <task> 。 单 见 的 场景 是 第 一 次 构建 包 且 在 编译 包 的 时 候 友 现 错误 ， 对 源 代 码 做 出 调整 或 者 修改 配置 ， 然 后 再 次 运行 
compile 任 务 来 验证 变更 是 否 已 经 解决 了 问题 : 

9 bitbake busybox 

Gore 

[make some changes to the source code] 

S bitbake busybox -c compile 


单独 重新 执行 任务 允许 你 在 构建 过 程 的 任何 阶段 做 变更 然后 仅仅 执行 被 变更 影响 的 任务 。 因 为 BitBake 为 任务 的 每 次 执行 创建 日 志文 件 ， 所 以 被 进程 
ID 所 区 分 ， 你 可 以 轻松 地 分 析 修 改 的 效果 。 


一 旦 变更 有 了 希望 的 结果 ， 你 需要 把 它们 和 一 般 构 建 过 程 集成 起 来 。 因 为 在 包 的 构建 目录 中 做 出 的 修改 是 不 永久 的 并 且 在 清理 构建 目录 时 会 被 擦 
挤 ， 所 以 需要 通过 修改 菜谱 、 创 建 追加 文件 、 包 含 额外 的 补丁 等 来 增加 它们 到 构建 过 程 。 


5.2.2 ”任务 脚本 文件 
对 一 个 任务 的 每 次 执行 ，BitBake 创 建 包含 当 运 行 任 务 时 其 所 执行 的 命令 的 脚本 文件 。 任 务 脚本 文件 位 于 和 任务 日 志文 件 相同 的 目录 中 : 


T = "${WORKDIR}/temp" 


任务 脚本 文件 被 命名 为 : 


run.do_<taskname>.<pid> 


<pid> 后 缀 用 于 区 分 对 于 多 次 执行 的 相同 任务 的 脚本 文件 。 不 带 进 程 ID 后 经 的 文件 run.do_ <taskname> 是 一 个 符号 链接 ， 其 指向 BitBake 为 任务 的 
最 新 运行 执行 的 脚本 文件 。 

用 于 Python 任务 的 脚本 文件 是 从 继承 和 访问 BitBake 数 据 字 典 的 BitBake 构 建 环境 内 部 执行 的 。 用 于 shell 任 务 的 脚本 文件 包含 整个 构建 环境 ， 并 且 是 
通过 派生 进程 执行 的 。 在 很 多 情况 下 ， 它 们 可 以 直接 从 命令 行 运行 。 


文件 log.task_order 包 含 任务 及 其 对 应 的 脚本 文件 和 用 于 最 新 执行 的 进程 ID 的 列表 。 


5.3 ”分析 元 数据 


整个 BitBake 构 建 过 程 是 由 元 数据 驱动 的 。 可 执行 元 数据 提供 过 程 步骤 ， 它 们 是 通过 不 同 变量 的 值 来 配置 的 。 这 些 变量 中 的 很 多 依赖 于 特定 荣 谱 的 执 
行 上 下 文 。 例 如 ， 类 似 SRC_URI 的 变量 是 由 每 个 菜谱 定义 的 。 很 多 变量 也 引用 其 他 变量 ,它们 在 执行 上 下 文中 扩展 。 条 件 变量 设置 和 追加 是 用 于 动态 调 
整 执行 上 下 文 的 强大 概念 但 是 在 调试 构建 失败 时 也 增加 了 复杂 性 。 


从 变量 名 字 和 设置 中 的 简单 的 错别字 到 不 正确 的 变量 扩展 和 条 件 赋值 ， 对 构建 过 程 来 阅 ， 失 败 或 产生 不 正确 的 输出 的 可 能 很 多 。 因 此 ， 能 够 分 析 构 
建 系统 用 于 不 同上 下 文 内 的 变量 设置 是 重要 的 。 命 令 


S bitbake -e 


打印 用 于 全 局 BitBake 环 境 的 数据 字典 到 控制 台 。 在 其 潜在 地 被 特定 菜谱 上 下 文 履 盖 之 前 检查 默认 设置 是 有 用 的 。 用 带 有 目标 的 命令 显示 用 于 那个 特 


定 目标 的 数据 字典 条 目 : 
S bitbake -e <target> 


XAD CRAE CHEN, AARS Res NMeTA Tsai. BitBake EAA rR Pee. Whe SAAS 
使 得 输出 相当 宛 长 难以 分 析 。 不 幸 的 是 ， 不 管 BitBake 还 是 OpenEmbedded 都 没有 提供 仪 仅 列 出 变量 的 功能 。 然 而 ， 通 过 包含 程序 清单 5-7 中 的 代码 到 
类 文件 中 ， 这 个 功能 可 以 被 简单 地 增加 。 


程序 清单 5-7” showvars 任 务 


addtask showvars 
do_showvars[nostamp] = "1" 


python do_showvars() { 
# emit only the metadata that are variables and not functions 


isfunc = lambda key: bool(d.getVarFlag(key, 'func') ) 
vars = sorted((key for key in bb.data.keys(d) \ 
if not key.startswith('__'))) 
for var in vars: 
ift not isfunc(var): 
Live 
val = d.getVar(var, True) 
except Exception as exc: 
bb.plain('Expansion of %s threw %s: %s' % \ 
(var, exc. class . name , str(exc))) 
bb.plain('%s="%s"' % (var, val)) 


当 和 
S bitbake <target> -C showvars 
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5.5 ”依赖 性 关系 图 


在 第 4 章 中 ， 我 们 看 到 包 是 如 何 使 用 它们 菜谱 中 的 DEPENDS 和 RDEPENDS 变 量 来 声明 对 其 他 包 的 直接 的 构建 时 和 运行 时 依赖 性 的 。 你 可 以 简单 地 意 
识 到 ， 这 个 实践 可 以 如 何 导致 长 且 复 杂 的 依赖 性 链 。 


当然 ，BitBake 必 须 能 够 解析 这 些 依赖 性 链 以 用 正确 的 顺序 来 构建 包 。 使 用 它 的 依赖 性 解析 器 ，BitBake 也 可 以 创建 用 于 分 析 和 调试 的 依赖 性 关系 
Z, 


BitBake 使 用 DOT 普 通 文本 图 形 摘 述 语言 来 创建 依赖 性 天 系 图 。DOT 以 一 种 可 以 被 人 和 计算 机 程序 共同 读 取 的 语言 


言 来 提供 一 种 描述 带 有 节点 和 边缘 
的 无 向 和 有 向 图 的 简单 方法 。 来 自 Graphviz (www.graphviz.org) 包 的 程序 以 及 许多 其 他 程序 可 以 读 取 DOT 文 件 并 且 将 


其 泻 染 成 图 形 展示 。 
为 了 为 目标 创建 依赖 性 关系 图 ， 用 -g 或 者 --graphviz 选 项 调用 BitBake。 使 用 


S bitbake -g <target> 
为 <target> 创 建 以 下 的 依赖 性 文件 : 
- pn-buildlist: 这 个 文件 不 是 DOT 文 件 但 是 包含 以 目标 开始 的 逆向 构建 顺序 的 包 列 表 。 
- pn-depends.dot: 包含 首先 声明 


节点 然后 声明 边缘 的 有 向 图 中 的 包 依 赖 性 。 


- package-depends.dot: 本 质 上 和 pn-depends.dot 一 样 但 是 紧 接 节点 之 后 为 节点 声明 边缘 。 这 个 文件 可 能 更 易于 被 人 读 取 ， 因 为 
的 边缘 和 节点 一 起 分 组 。 


它 会 将 终结 于 节点 


-task-depends.dot: 声明 在 任务 级 别 上 的 依赖 性 。 


BitBake 也 提供 了 内 置 的 用 于 包 依赖 性 的 用 户 界面 一 一 依赖 性 浏览 器 。 你 可 以 用 如 下 的 命令 启动 依赖 性 浏览 器 : 


9 bitbake -g -u depexp <target> 


依赖 性 浏览 器 使 你 能 够 在 图 形 用户 界 面 内 分 析 构 建 时 和 运行 时 依赖 性 以 及 逆向 依赖 性 (ART ERT ALE) ， 如 图 5-1 所 示 。 
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图 5-1 依赖 性 浏览 器 


如 果 Graphviz 包 安装 在 开发 系统 上， 那么 你 可 以 使 用 它 来 创建 依赖 性 关系 图 的 可 视 化 泻 染 : 


S dot -Tpng pn-depends.dot -o pn-depends.png 


从 DOT 文 件 创建 PNG 文 件 。 


5.7 BS 


本 章 介 绍 了 大 量 由 OpenEmbedded 构 建 系统 提供 的 用 于 辅助 排除 构建 失败 故障 的 工具 。 分 离 问题 的 根本 原因 仪 仪 是 第 一 步 。 第 二 步 是 找到 解决 方 
案 ， 它 可 能 更 具 挑 战 性 。 然 而 ， 在 很 多 情况 下 ， 其 他 开发 者 可 能 已 经 遇 到 过 相同 或 者 类 似 的 问题 ， 并 且 搜 索 互 联网 常 弟 引 发 一 个 或 者 更 多 关于 问题 和 可 


能 解决 方案 的 讨论 。 
日 志文 件 是 用 于 识别 失败 位 置 的 好 起 点 。 任 务 日 志文 件 包 含 任务 所 执行 的 命令 的 全 部 输出 。 
` 播 入 你 自己 的 日 志 消 息 到 菜谱 和 类 中 可 以 帮助 查 明 构建 失败 。 
.多 次 执行 特定 任务 允许 对 比 结果 。 任 务 日 志文 件 不 被 连续 的 执行 所 履 盖 。 
打印 元 数据 显示 它们 的 任务 上 下 文中 的 变量 ， 包 含 变 量 扩展 和 条 件 赋值 。 
- 开发 shell 允 许 在 BitBake 使 用 的 相同 的 交叉 构建 环境 中 执行 make 目 标 。 
- 依赖 性 关系 图 支持 追踪 由 软件 包 之 间 未 被 解决 的 依赖 性 导致 的 构建 失败 。 


bitbake-layers 实 用 程序 提供 了 一 组 辅助 调试 使 用 多 个 层 的 构建 环境 的 函数 。 


S68 ”Linux 系 统 架 构 


在 前 面 的 章节 中 ， 我 们 介绍 了 Yocto 项 目 和 OpenEmbedded 构 建 系统 的 核心 概念 和 组 件 。 在 我 们 详细 探索 如 何 用 Yocto 项 目 构建 我 们 目 己 的 定制 
Linux 友 行 版 之 前 ， 是 时 候 后 退 一 步 看 看 是 什么 组 成 了 Linux 系 统 。 


理解 Linux 系 统 的 架构 为 OpenEmbedded 核 心 用 来 创建 各 种 系统 组 件 (例如 根 文件 系 统 、 内 核 镜 像 和 引导 加 载 程序 ) 的 方法 提供 了 上 下 文 。 


我 们 首先 看 看 Linux 系 统 的 剖 析 ， 然 后 将 其 分 解 成 它 的 组 件 。 


6.1 Linux 或 者 GNU/Linux? 


你 可 能 已 经 注意 到 了 ， 人 在 一 些 上 下 文中 ，Linux 操 作 系 统 被 称 为 Linux， 而 在 另 一 些 上 下 文中 则 被 称 为 GNU/Linux。 这 种 区 别 背 后 的 原因 是 ， 严 格 来 
说 ， 名 字 Linux 仅 仅 措 的 是 作为 操作 系统 的 基础 或 者 核心 的 Linux 内 核 。 


为 了 操作 系统 可 以 有 用 ， 更 多 的 应 用 和 库 是 被 需要 的 一 一 开发 工具 、 编 译 器 、 编 辑 器 、shell、 实 用 程序 等 一 一 它们 不 是 内 核 的 一 部 分 。 大 量 的 这 些 
应 用 是 由 Richard Stallman 在 1984 年 启动 的 GNU 项 目 所 提供 的 。 可 能 来 自 GNU 项 目的 最 知名 的 工具 是 GCC 编 译 器 、GLIBC 库 和 EMACS 编 辑 器 。 关 于 
GNU 很 少 知道 的 是 ， 它 也 包含 被 称 为 Hurdl 1 的 操作 系统 内 核 。 


为 几乎 所 有 用 于 桌面 和 服务 器 应 用 的 Linux 操 作 系 统 都 包含 很 多 GNU 项 目 软 件 包 ， 所 以 很 多 人 认为 GNU/Linux 是 用 于 操作 系统 的 更 加 恰当 的 名 
字 ， 而 当 仪 仪 指 的 是 内 核 时 ，Linux 是 合适 的 。 


藤 入 式 Linux 操 作 系统 通 弟 不 包含 大 量 工 具 和 应 用 ， 因 为 它们 是 专用 于 特定 用 例 的 。 通 常 ， 除 了 对 铅 入 式 设备 来 说 必要 的 特定 应 用 以 外 ， 你 会 友 现 有 
限 集合 的 标准 工具 ， 例 如 shell、 编 辑 器 和 少量 实用 程序 。 常 见 的 是 ， 那 组 应 用 是 在 单一 的 工具 盒子 (例如 BusyBox) 中 提供 的 。 


[1] https://www.gnu.org/software/hurd/hurd.html. 


6.2 ”Linux 系 统 的 剖析 


图 6-1 拉 u 述 了 Linux 系 统 架 构 的 高 度 概 换 。 引 导 加 载 程序 不 严格 是 Linux 系 统 的 一 部 分 ， 但 是 对 于 启动 系统 它 是 必需 的 ， 所 以 在 用 Yocto 项 目 构建 完整 
功能 性 的 系统 的 上 下 文中 其 也 是 相关 的 。 
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4 
用 户 应 用 和 库 
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图 6-1 ”Linux 操 作 系 统 架 构 


Linux 操 作 系统 可 以 被 划分 成 两 个 级 别 ， 内 核 空间 以 及 用 户 或 应 用 空间 。 这 种 区 分 不 只 是 概念 性 的 ， 而 是 起 源 于 事实 一 一 来 目 内 核 空 间 的 代码 相对 于 
来 目 用 户 空间 的 代码 是 在 不 同 的 处 理 器 操作 模式 下 被 执行 的 。 


所 有 内 核 代 码 都 是 在 非 受 限制 或 者 特权 的 模式 | 中 被 执行 的 。 在 这 种 模式 下 ， 架 构 的 指令 集 的 所 有 指令 都 可 以 被 执行 。 相 反 ， 应 用 代码 是 在 受 限制 
或 者 用 户 的 模式 中 被 执行 的 。 在 这 个 模式 下 ， 直 接 访 问 硬件 的 指令 一 一 输入 /和 输出 (Input/Output, 1/0) 指令 一 一 或 者 其 他 可 以 改变 机 器 状态 的 指令 是 
不 被 允许 的 。 对 特定 内 存 区 域 的 访问 通常 也 是 被 限制 的 。 





从 用 户 模式 改变 到 内 核 模 式 需 要 CPU 切换 上 下 文 ， 它 是 由 依赖 于 架构 的 特殊 指令 来 实现 的 。 例 如 ， 在 遗留 的 x86 CPUE, int 80h 软 件 中 断 或 者 陷阱 
实现 了 那个 目的 。 新 的 x86 64 CPU 提供 syscall 指 令 ， 是 它 被 使 用 而 不 是 int 80h 陷 阱 。 


[1] 和 几乎 所 有 事情 一 样 ， 有 规则 的 例外 。uClinux 项 目 Chttp://www.uclinux.org) 构建 了 一 个 针对 没有 内 存 管 理 系统 的 微 控制 器 的 Linux 系 统 。 


Proxy Error 


The proxy server received an invalid response from an upstream server. 
The proxy server could not handle the request GET /resource/readBook. 


Reason: Error reading from remote server 


6.3.2 Linux 引 导 加 载 程序 


作为 Linux 系 统 开 友 者 ， 对 项 目 来 讽 ， 你 有 很 多 用 于 引导 加 载 程序 的 选择 。5 引 导 加 载 程序 在 功能 性 、 处 理 器 和 操作 系统 广 持 方面 有 孝 异 。 它 们 中 的 很 
多 不 但 可 以 启动 Linux 也 可 以 局 动 其 他 操作 系统 。 另 一 个 区 别 是 它们 可 以 从 什么 介质 启动 操作 系统 。 除 了 软盘 (floppy disk) . RAMUS FRSE, 6 
们 中 的 很 多 也 可 以 通过 BOOTP 和 TFTP 从 LAN 启 动 。 


当选 择 引导 加 载 程序 时 ， 架 构 和 局 动 介质 文 持 是 首先 要 考虑 的 。 人 在 开 友 中 ， 监 控 功 能 性 可 以 极 大 地 加 速 往 返 开 上 友 工 程 化 和 优化 局 动 参数 。 然 而 ， 当 
开 友 已 经 完成 并 且 已 完成 产品 被 部 署 时 ， 监 控 功 能 性 可 能 成 为 孝 厅 烦 的 事 ， 因 为 用 户 可 能 不 经 意 地 (或 者 是 故意 地 ) 进入 监控 模式 。 一 些 提供 监控 能 力 
的 引导 加 载 程序 可 以 被 重新 配置 以 允许 或 者 禁止 对 监控 特性 的 访问 或 者 可 以 用 密码 来 保护 监控 模式 。 然 而 ， 最 安全 的 选项 ， 是 在 编译 时 就 移 除 监 控 能 
JJ: 
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加 完整 的 Linux 引 导 加 载 程序 的 摘 述 ， 它 们 是 被 包含 的 。 不 是 所 有 的 散 入 式 系统 都 是 同等 创建 的 ， 最 终 你 可 能 友 现 你 自己 正在 写 用 于 引导 加 载 程序 的 、 比 
默认 被 Yocto 项 目 支 持 的 那些 更 加 适合 应 用 的 菜谱 。 


几乎 所 有 引导 加 载 程序 都 允许 在 默认 被 局 动 (在 可 配置 的 超时 之 后 ) 之 前 从 菜单 选择 不 同 的 系统 。 这 是 对 笔记 本 、 叶 面 和 服务 器 计算 机 来 说 的 常见 
实践 ， 给 用 尸 选择 以 局 动 失败 安全 或 者 有 限 的 系统 或 者 在 系统 被 修改 后 的 预先 工作 的 配置 。 对 藤 入 式 系 统 来 说， 这 个 功能 性 可 以 被 用 来 回 退 到 早期 版 
本 ， 例 如 ， 如 果 系 统 升级 已 经 失败 了 。 
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在 我 们 更 细节 地 讨论 引导 加 载 程序 之 前 ， 关 于 架构 的 一 点 注意 : 对 x86 的 引用 总 是 隐 含 着 PC 平台 。 这 个 平台 在 内 和 存 布局 、 总 线 和 外 设 方面 大 部 分 是 
标准 化 的 。 它 也 包含 BIlOS， 也 提供 对 二 次 引导 加 载 程序 和 操作 系统 配置 信息 的 第 一 阶段 引导 加 载 程序 。 这 使 得 它 是 相当 不 同 于 其 他 架构 的 ， 例 如 ARM 和 
PPC， 对 它们 没有 标准 化 的 平台 。 昌 然 不 同 平台 使 用 市 有 相同 架构 内 存 布 局 的 CPU， 但 是 思 线 和 外 设 可 能 非常 不 同 。 那 些 平台 通常 也 没有 BIOS 或 者 任何 
其 他 标准 化 的 用 于 获取 系统 配置 的 方法 。 那 要 求 引导 加 载 程序 被 特定 地 改变 成 适合 特殊 平台 。 


LILO 


LILO (Linux 引 导 加 载 程序 ，Linux LOader) 曾经 是 用 于 针对 x86 系 统 的 几乎 所 有 Linux 发 行 版 的 标准 引导 加 载 程序 。 最 初 由 Werner Almesberger 
在 1992 年 到 1998 年 之 间 开 发 的 ，John Coffman 从 1999 年 到 2007 年 之 间接 管 维护 ， 而 自 2010 年 起 ，Joachim Wiedorn 一 直 在 维护 项 目 。 虽 然 自从 2013 


年 GNU GRUB 已 经 作为 用 于 很 多 Linux 发 行 版 的 默认 引导 加 载 程序 而 成 功 地 奉 代 了 LILO， 但 是 项 目 仍 然 是 活跃 的 。LILO 相 对 于 很 多 其 他 引导 加 载 程序 的 
主要 优势 是 ， 它 是 文件 系统 不 可 知 的 。 操 作 系统 可 以 存在 任何 文件 系统 上 ， 包括 NTFS、EXT4、FAT32 以 及 相对 新 的 BTRFS， 并 且 LILO 可 以 无 天 地 启动 
它 。LILO 可 以 直接 从 软盘 和 硬盘 启动 Linux 内 核 镜像 。LILO 是 很 好 的 文档 化 的 并 且 作 为 很 多 应 用 的 切实 可 行 的 选项 ， 在 这 些 应 用 中 ， 例 如 GRUB 的 更 复杂 
的 引导 加 载 程序 是 不 需要 的 。 


ELILO 


ELILO (基于 EFI 的 Linux 引 导 加 载 程序 ，EFl-based Linux LOader) 是 由 Hewlett-Packard 做 出 的 用 于 支持 基于 EFI 的 硬件 的 LILO 的 分 支 。 另 外 ， 它 
通过 BOOTP、DHCP 和 TFTP 协 议 处理 网 络 启动 。 


GRUB 


GRUB (GNU GRand Unified Bootloader) 最 初 是 由 Erich Stefan Boleyn 设 计 和 实现 的 。 从 2013 年 开始 ， 它 开始 替代 LILO 作 为 用 于 Linux 发 行 版 
的 主流 的 引导 加 载 程序 。 


GRUB 最 终 被 GRUB 2 所 替代 ， 现 在 被 称 为 GRUB Legacy。 今 天 ， 术 语 GRUB 通 常 指 的 是 GRUB 2, 


PUPA 研 究 项 目 为 GRUB 2 创建 了 基础 ， 并 且 最 终 演化 成 了 GRUB 2。GRUB 2 是 完全 的 重 写 ， 并 且 它 相关 于 GRUB Legacy 仅 仅 是 因为 它 的 名 字 。 
GRUB 2 使 用 来 自 Etherboot[1] 开 源 软件 包 的 驱动 来 处 理 借 由 BOOTP、DHCP 和 TFTP 协 议 的 网 络 启动 。 


SYSLINUX 
Syslinu xB EZ TATA Bee 25 |SITE Aine : 
- SYSLINUX: 用 于 FAT 和 NTFS 文 件 系 统 ， 可 以 处 理 硬盘 、 软 盘 和 USB 盘 的 引导 加 载 程序 。 
- ISOLINUX: 用 于 可 启动 El Totito CD-ROM 的 引导 加 载 程序 。 
- EXTLINUX: 用 于 Linux EXT2/EXT3/EXT4 和 BTRFS 文 件 系统 的 引导 加 载 程序 。 


- PXELINUX: 用 于 借 由 BOOTP、DHCP 和 TEFTP 使 用 大 多 数 网 络 硬 件 所 支持 的 预 启 动 执行 环境 (Preboot Execution Environment, PXE) 的 引导 加 载 
程序 。 


虽然 稳定 ， 但 是 Syslinux 是 一 个 活跃 的 项 目 ， 其 最 新 友 布 也 支持 启动 基于 EFI 的 硬件 。 
U-Boot 


U-Boot (统一 引导 加 载 程 序 ，Universal Bootloader) ， 也 被 称 为 Das U-Boot， 可 以 被 认为 是 坐 入 式 引 导 加 载 程序 中 的 瑞士 军刀 。 基 于 PPCBoot 
和 ARMBoot 项 目 ， 并 且 最 初 由 来 自 DENX 软 件 工程 的 Wolfgang Denk 所 开发 ，U-Boot 是 最 具有 丰富 特性 、 灵 活 的 、 被 活跃 开发 的 当前 可 用 的 引导 加 载 
程序 之 一 。 


对 硬件 平台 的 大 量 支持 仪 仅 是 U-Boot 的 众多 特性 之 一 。 在 这 个 写作 的 时 | 间 ，U-Boot 支 持 超 过 1000 个 平台 ， 其 中 超过 600 个 是 基于 PowerPC 的 以 及 
超过 300 个 是 基于 ARM 的 。 如 果 项 目 使 用 任何 这 些 染 构 ， 那 么 机 会 是 硬件 平台 已 经 被 U-Boot 所 支持 。 即 使 它 不 是 被 支持 的 ， 你 将 有 很 大 可 能 找到 一 个 可 
以 派生 上 自己 的 平台 支持 代码 的 相近 匹配 。 


U-Boot 也 支持 用 于 平台 配置 的 设备 树 (device trees) 。 设 备 树 ， 也 被 称 为 开放 固件 (open firmware) 或 者 扁平 的 设备 树 (Flattened Device 
Tree, FDT) ， 是 字 节 码 (byte code) 形式 的 数据 结构 其 中 包含 例如 寄存 器 位 置 和 和 大小、 地 址 、 中 断 等 平台 特定 的 参数 ， 该 参数 被 Linux 内 核 所 需要 以 
正确 地 访问 硬件 和 启动 。U-Boot 复 制 设备 树 数据 结构 到 内 存 位 置 。 设 备 树 背后 的 理念 是 ， 在 运行 时 提供 平台 配置 参数 ， 人 允许 Linux 内 核 可 以 被 编译 成 用 
于 多 个 平台 ， 而 不 用 关于 特殊 平台 的 特定 信息 。 


U-Boot 有 很 好 的 文档 记录 。 主 要 文档 是 The DENX U-Boot and Linux Guide (DULG) 四 。 除 了 那个 指南 ， 有 非常 细节 的 、 包 含 在 U-Boot 源 中 的 
READM Ex 文件 。 


U-Boot 源 仓库 位 于 http://git.denx.de。 


BURG 


BURG (新 统一 引导 加 载 程序 ，Brand-new Universal loadeR) 是 从 GRUB 衍 生 的 近来 的 引导 加 载 程序 。 初 囊 是 为 了 支持 更 广泛 的 操作 系统 和 有 很 
多 主题 以 在 启动 中 定制 引导 加 载 程序 的 外 观 的 能 力 。BURG 还 没有 被 广泛 使 用 ， 因 为 它 还 没有 被 主 法 Linux 发 行 版 所 采用 。 像 GRUB， 它 仅 仪 文 持 x86 系 统 
但 是 提供 GRUB 的 所 有 特性 ， 包 括 借 由 BOOTP、DHCP 和 TFTP 的 网 络 启动 。 


systemd-boot 


systemd-boot 是 定位 于 UEFI 系 统 的 简单 的 引导 加 载 程序 。 它 执行 位 于 EFI 系 统 分 区 (EFI System Partition, ESP) 上 的 镜像 。 所 有 用 于 引导 加 载 程 
序 的 配置 文件 和 操作 系统 需要 存在 于 EFI 系 统 分 区 上 。Linux 内 核 需 要 通过 设置 CONFIG EFI STUB 参 数 来 配置 EFI 启 动 ， 以 便 systemd-boot 可 以 直接 将 其 
作为 EFI 镜 像 执 行 。 


RedBoot 


RedBoot (Red Hat 嵌 入 式 调 试 和 启动 固件 ，Red Hat Embedded Debug and Bootstrap Firmware) 是 基于 eCos 硬 件 抽象 层 的 引导 加 载 程序 。 
eCos 是 免费 的 、 开 源 的 、 实 时 的 、 定 位 于 肉 入 式 应 用 的 操作 系统 。eCos 和 RedBoot 最 初 是 由 Red Hat 所 开发 和 维护 的 ， 但 是 该 公司 已 经 中 断 了 开发 ， 所 
有 源 因此 被 GPL 重新 授权 。 活 跃 的 开发 和 维护 已 经 被 eCosCentric 公 司 所 接管 中 ，eCosCentric 是 由 来 自 Red Hat 的 核心 eCos 开 发 者 所 建立 的 。 


因为 它 的 eCos 传 统 ，RedBoot 为 几乎 所 有 架构 支持 很 多 内 入 式 硬件 平台 ， 这 些 架 构 中 束 有 ARM、MIPS、PPC 和 和 x86。 
RedBoot 的 网 络 支 持 包 括 BOOTP 和 DHCP。 它 可 以 通过 以 太 网 使 用 TFTP 和 通过 串 行 连接 使 用 X-modem 或 者 Y-modem 协 议 下 载 镜像 。 


市 有 交互 命令 行 接口 的 监控 功能 允许 RedBoot 配 置 、 镜 像 下 载 和 管理 以 及 局 动 脚本 化 。 这 样 的 特性 可 以 用 于 开 友 以 及 用 于 部 署 在 现场 的 系统 以 进行 
远程 升级 。 


[1] http://etherboot.org/wiki/index.php. 
[2] www.denx.de/wiki/DULG/Manual. 


[3] www.ecoscenttic.com. 


6.4 Ary 


操作 系统 的 内 核 的 两 个 主要 功能 是 : 

- 管理 计算 机 资源 

- 允许 其 他 程序 执行 和 访问 资源 

计算 机 的 核心 资源 通常 是 由 以 下 组 成 的 : 

CPU: CPU 是 用 于 程序 的 执行 单元 。 内 核 负 责 分 配 程序 到 处 理 器 (调度 ) 和 设置 执行 环境 (分派) o 


(AG: 内 存 为 程序 存储 指令 和 数据 。 多 个 程序 竞争 内 存 ， 并 且 程 序 可 以 要 求 比 在 系统 中 物理 可 用 的 更 多 的 内 存 (虚拟 内 存 ) 。 内 核 负责 向 程序 分 
配 内 存 、 保 护 内 存 并 且 决 定 如 果 程序 请 求 了 多 于 可 用 的 内 存 时 会 发 生 什么 ， 在 大 部 分 情况 下 ， 它 是 小 于 计算 机 的 物理 内 存 的 。 


“I/O 设备 : 1/O 设 备 代表 用 于 数据 的 源 和 水 模 ， 例 如 键盘 、 自 标 、 显 示 器 、 网 络 接口 、 存 储 等 。 内 核 负责 通过 统一 的 、 从 底层 硬件 的 规格 中 抽象 出 
来 的 编程 接口 来 服务 程序 与 设备 交换 数据 的 请 求 。 


操作 系统 内 核 架 构 通常 被 分 类 成 单 内 核 (monolithic kernel) 和 微 内 核 (microkernel) 。 单 内 核 执 行 所 有 内 核 功 能 ， 包 括 在 核心 内 核 进程 和 内 存 
上 下 文中 的 设备 驱动 。 微 内 核 仅仅 执行 核心 功能 ， 例 如 在 核心 内 核 上 下 文中 的 进程 和 内 存 绾 理 ， 并 且 作 为 用 户 空间 进程 执行 设备 驱动 。 微 内 核 允 许 更 简 
单 的 系统 配置 和 维护 ， 因 为 设备 驱动 可 以 在 系统 运行 时 被 加 载 和 和 纯 载 。 然 而 ， 那 种 便利 性 是 以 性 能 损失 为 代价 的 ， 因 为 微 内 核 使 用 进程 间 通 信 
(Interprocess Communication, IPC) 来 在 内 核 模块 乙 间 交换 数据 。 


虽然 Linux 内 核 为 在 执行 时 可 以 被 加 载 和 和 弛 载 的 设备 驱动 提供 可 加 载 的 内 核 模 块 ， 但 是 Linux 被 认为 是 单 内 核 ， 因 为 这 些 模块 被 直接 插入 进 内 核 的 执 
行 上 下 文中 。 因 为 它们 是 运行 在 内 核 的 执行 上 下 文中 ，Linux 内 核 模 块 拥有 对 所 有 系统 资源 的 访问 。 因 此 ， 进 程 间 通信 对 于 交换 数据 是 不 必需 的 ， 故 而 没 
有 性 能 损失 。 


微 内 核 架 构 的 支持 者 声明 ， 它 是 优 于 单 内 核 染 构 的 ， 因 为 它 是 更 加 干净 的 设计 并 且 故 障 的 设备 驱动 不 能 破坏 整个 系统 。 按 照 他 们 的 说 法 ， 这 个 优势 
比 因为 增加 的 上 下 文 切换 和 进程 间 通 信 所 导致 的 性 能 损失 更 重要 。 这 个 问题 成 了 在 Linus Torvalds 和 Minix Os 创 造 者 Andrew S.Tanenbaum 之 间 的 长 期 


存在 的 辩论 上 


[1] Andrew S.Tanenbaum, “Linux Is Obsolete,” 1992 年 1 月 29 日 ， https: //groups.google.com/forum/#!msg/comp.os.minix/wlhw16QWItI/XdksCA1TR_QJ. 


6.4.2 Linux 内核 启动 


既然 我 们 已 经 讨论 了 主要 的 内 核子 系统 ， 那 么 让 我 们 从 高 层 看 看 Linux 内 核 启动 过 程 。 为 了 这 个 讨论 的 上 下 文 ， 理 解 控 制 是 如 何 从 引导 加 载 程序 传 到 
内 核 然 后 最 终 传 到 用 户 空间 应 用 程序 (init 进 程 ) 是 足够 的 。 事 实 上 ，Linux 内 核 经 过 很 多 用 于 各 种 硬件 组 件 和 子 系统 的 初始 化 阶段 。 很 多 这 些 阶 段 依赖 
于 硬件 平台 。 


在 引导 加 载 程序 已 经 复制 Linux 内 核 镜像 进入 内 存 之 后 ， 它 把 控制 传 给 是 内 核 镜像 的 前 新 增 部 分 的 启动 加 载 器 (bootstrap loader) 。 为 了 节省 空 
间 ， 内 核 镜像 通常 是 压缩 的 ， 并 且 为 内 核 创建 恰当 的 执行 环境 、 解 压 内 核 、 在 内 存 中 重 定位 内 核 、 然 后 传递 控制 给 内 核 是 启动 加 载 器 的 职责 。 启 动 加 载 
器 直接 把 控制 传 给 在 模块 中 的 内 核 进入 点 ， 对 大 部 分 架构 来 说 ， 它 是 head.o。 


模块 head.o 包 含 用 于 特定 CPU 的 架构 特定 但 是 平台 独立 的 初始 化 代码 。 这 个 模块 是 从 汇编 语言 文件 head.S 中 衍生 出 来 的 ，head.S 位 于 
linux/arch/<ARCH>/kernel 目 录 内 ， 其 中 <ARCH> 被 特定 架构 所 替换 ，。 


从 高 层 来 看 ，head.o 模 块 执行 下 面 的 任务 : 
: 验证 正确 的 架构 和 CPU 
- 检测 CPU 类 型 和 功能 性 ， 例 如 硬件 浮 点 型 能 力 
` 局 用 CPU 的 内 存 管理 单元 并 且 创建 内 存 页 的 初始 表 
` 建立 基础 的 错误 报告 和 处 理 
切换 到 在 main.c 中 的 非 架构 特定 的 内 核 启 动 济 数 start_kernel0 


在 linux/init 中 的 main.c 包 括 大 段 的 Linux 内 核 启 动 代码 ， 从 架构 设置 、 内 核 命令 行 处 理 、 第 一 内 核 线 程 的 初始 化 到 挂 载 根 文件 系统 和 执行 第 一 个 用 
户 空 间 应 用 程序 。 


在 执行 了 基础 套 的 内 核 初 始 化 之 后 ，start kernel( 国 数 调 用 rest_init0， 它 派生 第 一 个 内 核 线程 。 这 个 线程 是 通过 将 函数 kernel_init( 作 为 第 一 个 参 
数 调用 kernel thread() 而 派生 的 。 这 个 函数 称 为 init 线 程 。 此 时 ， 有 两 个 线程 正在 执行 : start_kernel0 和 Kernel_init0。 前 者 启动 调度 器 然后 在 cpu_idle() 
国 数 中 无 限 循环 。 后 者 成 为 init(0 线 程 ， 即 是 带 有 进程 ID (PID) 为 1 的 所 有 用 户 空间 进程 的 父 进 程 。 


在 最 后 ，kernel_init(0 局 动 第 一 个 用 户 空间 应 用 。 如 果 init 命 令 作为 内 核 命令 行 的 一 部 分 而 被 传递 ， 那 么 kernel_init0 首 先 尝 试 局 动 那 个 程序 。 如 果 没 
有 init 命 令 被 传递 ， 那 么 函数 会 尝试 一 组 它 从 根 文件 系统 中 加 载 的 默认 程序 。 它 以 这 个 顺序 党 试 /sbiminit、/etcinit、/biminit 和 /bin/sh 直 到 成 功 。 如 
果 没 有 一 个 成 功 ， 那 么 内 核 以 著名 的 错误 消息 “No init found.Try passing init=option to the kernel.See Linux Documentation/init.txt for 


guidance.” 退 出 。 
通常 ， 第 一 个 用 户 空 间 进 程 是 称 后 局 动 其 他 用 户 进程 的 init 或 者 启动 系统 的 一 部 分 。 通 常 由 Linux 泉 面 和 服务 器 所 使 用 的 init 系 统 是 System V Init, 
systemd 和 Upstart。 府 入 式 系统 尝试 使 用 例如 BusyBox 的 更 轻 量 级 的 启动 系统 或 者 直接 启动 它们 的 核心 应 用 。 


Proxy Error 


The proxy server received an invalid response from an upstream server. 
The proxy server could not handle the request GET /resource/readBook. 


Reason: Error reading from remote server 


6.6 Bae 


Linux 操 作 系 统 栈 是 由 很 多 不 同 组 件 所 组 成 的 。 在 本 章 中 ,我们 仔细 检查 了 它 的 架构 以 为 天 于 OpenEmbedded 构 建 系统 如 何 构建 组 件 和 组 凌 它 们 成 


为 工作 的 Linux 系 统 的 讨论 创建 基础 。 


引导 加 载 程 序 在 系统 启动 中 扮演 着 短暂 但 是 重要 的 角色 。 引 导 加 载 程 序 的 职责 是 初始 化 硬件 、 加 载 与 启动 操作 系统 内 核 。 
` Linux 内 核 是 大 型 和 复杂 项 目 。 它 被 划分 成 各 种 提供 内 核 功能 性 和 把 它 从 底层 硬件 抽象 出 来 的 子 系 统 。 

内 核 的 系统 调用 接口 (System Call Interface, SCI) 是 内 核 和 用 户 空 间 应 用 的 桥梁 。 

用 户 空间 或 者 用 户 区 是 指 所 有 运行 在 内 核 以 外 的 代码 。 内 核 启动 第 一 用 户 空间 进程 。 


ILIBC 为 应 用 程序 提供 了 一 组 常用 的 应 用 程序 编程 接口 和 函数 。LIBC 去 除了 对 应 用 开发 者 来 说 处 理 系 统 错综复杂 之 处 的 需要 ， 并 且 使 得 应 用 程序 在 


不 同系 统 之 间 变 得 可 移植 。 


6.7 参考 文献 


内 核 文 档 ,，https://www.kernel.org/doc/Documentation。 


Ble ”构建 定制 Linux 发 行 版 


在 前 面 的 章节 中 ， 我 们 为 使 用 Yocto 项 目 工具 来 构建 定制 Linux 发 行 版 莫 定 了 基础 。 现 在 到 了 我 们 把 知识 用 在 工作 中 的 时 间 了 。 


第 2 草 简要 列 出 了 针对 构建 系统 的 先决 条 件 和 如 何 设置 构建 主机 、 配 置 构建 环境 以 及 启动 一 个 构建 ， 该 构建 创建 一 个 准备 运行 在 QEMU 模 拟 器 中 的 系 


。 本 章 我 们 将 重用 那个 构建 环境 。 如 果 你 还 没有 准备 构建 系统 ， 那 么 我 们 推荐 你 回 到 第 2 章 并 遵循 步骤 完成 。 执 行使 用 Poky 默 认 设置 的 构建 验证 设 
。 其 中 会 下 载 大 部 分 源 代 码 包 并 且 建 立 共 享 的 状态 缓 仔 ， 这 两 个 都 加 速 了 本 章 提供 的 例子 的 构建 时 间 。 


在 第 3 章 和 第 4 章 中 ， 我 们 解释 了 OpenEmbedded 构 建 系统 和 BitBake 语 法 。 本 章 和 接 下 来 的 章节 显示 了 使 用 那个 语法 的 BitBake 荣 谱 的 例子 或 者 片 


。 昌 然 语法 大 部 分 是 简单 直接 并 且 类 似 于 典型 的 脚本 语言 ， 但 是 有 一 些 特定 于 BitBake 的 构造 。 参 考 第 4 章 ， 你 会 找到 语法 例子 和 解释 。 


当 用 Yocto 项 目 实验 时 ， 你 肯定 会 遇 到 构建 失败 。 它 们 可 能 因为 各 种 原因 而 友 生 ， 并 且 故 障 排除 是 具有 挑战 性 的 。 你 可 以 参考 第 5 和 章 以 了 解 帮助 你 所 


中 构建 失败 的 工具 ，。 


第 6 草 概 要 摘 述 了 Linux 发 行 版 的 组 成 部 分 。 虽 然 引 导 加 载 程 序 和 Linux 内 核对 于 工作 的 Linux 操 作 系统 栈 来 说 是 不 可 分 割 的， 但 是 用 户 空 间 组 成 了 它 


的 大 部 分 。 在 本 章 中 ， 我 们 主要 关注 如 何 通 过 Yocto 项 目 提 供 的 菜谱 和 OpenEmbedded 项 目的 其 他 兼容 层 来 自 定义 Linux 操 作 系 统 栈 、 用 户 空 间 库 和 应 
用 程序 。 


7.1 核心 镜像 一 一 Linux 友 行 版 监 苞 


OpenEmbedded 核 心 和 其 他 Yocto 项 目 层 包括 一 些 样 例 镜像 。 这 些 镜 像 提 供用 于 典型 Linux 操 作 系统 栈 的 根 文 件 系 统 配置 。 它 们 包括 从 仅仅 司 动 设 


备 到 命令 行 提 示 的 非 单 基 础 的 镜像 到 包含 X 窗 口 系统 (X11) 服务 器 和 图 形 用 户 界 面 的 镜像 。 这 些 参考 镜像 似 称 作 核心 镜像 (core images) ， 因 为 它们 
各 目 菜 谱 的 名 字 都 以 core-image 开 头 。 你 可 以 从 你 构建 系统 的 安 委 目录 内 使 用 find 命 令 定位 用 于 核心 镜像 的 荣 谱 〈 见 程序 清单 7-1) 。 


程序 清单 7-1 核心 镜像 菜谱 


user@buildhost:~/yocto/pokys find ./meta*/recipes*/images -name "*.bb" 
-print 
./meta/recipes-core/images/core-image-minimal-initramfs.bb 
./meta/recipes-core/images/core-image-minimal-mtdutils.bb 
./meta/recipes-core/images/build-appliance-image_8.0.bb 
./meta/recipes-core/images/core-image-minimal-dev.bb 
./meta/recipes-core/images/core-image-minimal.bb 
./meta/recipes-core/images/core-image-base.bb 
./meta/recipes-extended/images/core-image-full-cmdline.bb 
./meta/recipes-extended/images/core-image-testmaster-initramfs.bb 
./meta/recipes-extended/images/core-image-lsb-sdk.bb 
./meta/recipes-extended/images/core-image-lsb-dev.bb 
./meta/recipes-extended/images/core-image-lsb.bb 
./meta/recipes-extended/images/core-image-testmaster.bb 
./meta/recipes-graphics/images/core-image-x11.bb 
./meta/recipes-graphics/images/core-image-directfb.bb 
./meta/recipes-graphics/images/core-image-weston. bb 
./meta/recipes-graphics/images/core-image-clutter.bb 
./meta/recipes-qt/images/qt4e-demo-image.bb 
./meta/recipes-rt/images/core-image-rt-sdk.bb 
./meta/recipes-rt/images/core-image-rt.bb 
./meta/recipes-sato/images/core-image-sato-dev.bb 
./meta/recipes-sato/images/core-image-sato-sdk.bb 
./meta/recipes-sato/images/core-image-sato.bb 
./meta-skeleton/recipes-multilib/images/core-image-multilib-example.bb 


可 以 把 核心 镜像 视 作 通过 扩展 它们 可 以 从 其 中 获得 你 自己 的 发 行 版 的 Linux 发 行 版 蓝图 。 所 有 核心 镜像 菜谱 都 继承 自 core-image 类 ，core-image 类 
目 己 从 image 类 继承 。 所 有 镜像 设置 IMAGE_INSTALL 变 量 来 指定 什么 包 被 安 妆 进 根 文件 系统 。IMAGE INSTALL 是 包 和 包 组 (package group) 的 列 
表 。 包 组 是 包 的 集合 。 定 义 包 组 减少 了 潜在 的 在 IMAGE_INSTALL 变 量 中 询 出 数 百 个 单一 包 的 需求 。 我 们 人 在 本 章 接 下 来 的 部 分 会 解释 包 组 。 镜 像 菜谱 要 么 
显 式 地 设置 Image INSTALL， 要 么 扩展 它 自己 的 由 core-image 类 提供 的 默认 值 ， 由 core-image 类 提供 的 默认 值 安 装 packagegroup-core-boot 和 
packagegroup-base-extended 这 两 个 包 组 。 默 认 创 建 局 动 到 控制 台 的 工作 的 根 文件 系统 。 


让 我 们 更 进一步 地 看 看 各 种 核心 镜像 。 
- core-image-minimal: 这 是 允许 设备 启动 到 Linux 命 令 行 登录 的 最 基础 的 镜像 。 登 录 和 命令 行 解释 器 是 由 BusyBox 提 供 的 。 


- core-image-minimal-initramfs: 这 个 镜像 本 质 上 和 cote-imapge-minimal 一 样 ， 但 是 具有 包括 基于 RAM 的 初始 根 文 件 系统 (initramfs) 的 Linux 内 


核 。 


- core-image-minimal-mtdutils: 基于 core-image-minimal， 这 个 镜像 也 包含 用 户 空间 工具 来 与 在 Linux 内 核 中 的 内 存 技术 设备 (Memory Technology 


Device, MID) 子 系 统 交 互 以 在 闪存 设备 上 执行 操作 。 


- core-image-minimal-dev: 基于 core-image-minimal ， 这 个 镜像 也 包含 用 于 安装 在 根 文 件 系 统 中 的 所 有 包 的 全 部 开发 包 【 例 如 头 文件 ) 。 如 果 和 原 
生 目 标 工具 链 一 起 部 署 ， 那 么 它 多 许 在 目标 上 的 软件 开发 。 与 交叉 工具 链 一 起 ， 它 可 以 用 于 开发 主机 上 的 软件 开发 。 


- core-image-rt: 基于 core-image-minimal， 这 个 镜像 目标 构建 Yocto 项 目 实 时 内 核 (real-time kernel) 并 包含 用 于 实时 应 用 的 测试 套件 与 工具 。 


- core-image-rt-sdk: 除了 core-image-tt 之 外 ， 这 个 镜像 包含 由 所 有 已 安装 包 的 开发 包 所 组 成 的 系统 开发 工具 包 (System Development 


Kit, SDK) ; 开发 工具 例如 编译 器 、 汇 编程 序 (assembler) 和 链接 器 ， 以 及 性 能 测试 工具 和 Linux 内 核 开 发 包 。 这 个 镜像 允许 在 目标 上 的 软件 开发 。 


- core-image-base: 本 质 上 是 cotre-image-minimal， 这 个 镜像 也 包含 中 间 件 和 应 用 包 以 支持 大 量 如 WiFi、 蓝 牙 、 上 声卡 和 串 行 口 的 硬件 。 目 标 设备 必须 
包含 必要 的 硬件 组 件 并 且 Linux 内 核 必 须 为 它们 提供 支持 。 


- core-image-full-cmdline: 这 个 最 小 化 的 镜像 添加 典型 的 Linux 命 令 行 工具 (bash、acl、atttr、grep、sed 和 tar 等 ) 到 根 文件 系统 。 
- core-image-Isb: 这 个 镜像 包含 与 Linux 标 准 基 (Linux Standard Base, LSB) 规格 说 明 保持 一 致 性 所 需 的 包 。 
Core-image-lsb-dev: 这 个 镜像 和 corc-image-lsb 相 同 ,， 但 是 也 包含 安装 在 根 文件 系统 上 的 所 有 和 包 的 开发 包 。 


Core-image-lsb-sdk: 除了 core-image-lsb-dev 之 外 ， 这 个 镜像 包含 例如 编译 器 、 汇 编程 序 和 链接 器 ， 以 及 性 能 测试 工具 和 Linux 内 核 开发 包 的 开发 


- core-image-x11: 这 个 基础 的 图 形 镜像 包含 X11 服 务 器 和 X11 终 端 应 用 。 


- core-image-sato: 这 个 镜像 提供 包含 用 于 移动 设备 的 OpenedHand Sato 用 户 体 验 的 X11 支 持 。 除 了 Sato 屏 幕 管理 器 之 外 ， 镜 像 也 提供 一 些 使 用 Sato 


方案 的 应 用 ， 例 如 终端 、 编 辑 器 、 文 件 管理 器 和 一 些 游 戏 。 
- core-image-sato-dev: 这 个 镜像 和 cote-image-sato 相 同 ， 但 是 也 包含 安装 在 根 文件 系统 上 的 所 有 包 的 开发 包 。 


- core-image-sato-sdk: 除了 core-image-sato-dev 之 外 ， 这 个 镜像 包含 例如 编译 器 、 汇 编程 序 和 链接 器 ， 以 及 性 能 测试 工具 和 Linux 内 核 开 发 包 的 开 


发 工具 。 


- core-image-directfb: 将 DirectFB 用 于 图 形 化 和 输入 设备 管理 的 镜像 ，DirectFB 可 能 包含 图 形 化 加 速 和 窗口 系统 。 因 为 相 比 于 X11 内 存 占用 非常 


小 ，DitectFB 是 用 于 需要 图 形 化 支持 但 不 需要 完全 的 X11 功 能 性 的 低 端 嵌入 式 系统 的 较 佳 选择 。 
- core-image-clutter: 指示 基于 X11 且 包含 Cluttet 工 具 包 的 镜像 。Cluttet 基 于 OpenGL 并 且 提 供用 于 动画 图 形 用 户 界 面 的 功能 性 。 


- core-image-weston: 这 个 镜像 使 用 Weston 替 代 X11。Weston 是 使 用 Wayland 协 议和 实现 来 与 它 的 客户 端 交 换 数 据 的 合成 器 。 这 个 镜像 也 包含 拥有 


Wayland 能 力 的 终端 程序 。 


qt4e-demo-image: 这 个 镜像 在 完成 启动 过 程 后 启动 用 于 谱 入 式 Qt 工 具 包 的 演示 应 用 。 用 于 诬 入 式 Linux 的 Qt 提供 直接 写 到 框架 缓冲 区 的 图 形 化 
应 用 的 开发 框架 来 替代 使 用 X11 。 


- core-image-multilib-example: 这 个 镜像 是 支持 多 个 库 的 例子 ， 通 常 是 在 其 他 64 位 系统 上 对 32 位 的 支持 。 镜 像 基 于 核心 镜像 并 且 增 加 希望 的 多 
库 包 到 IMAGE_INSTALL。 


下 面 的 3 个 镜像 不 是 用 于 藤 入 式 Linux 系 统 的 参考 镜像 。 我 们 为 了 完整 性 的 目的 而 把 它们 包括 在 这 个 讨论 中 。 


- core-image-testmaster, core-image-testmaster-initramfs: 这 些 镜像 是 用 于 在 真实 硬件 设备 或 者 在 QEMU 中 测试 其 他 镜像 的 参考 。 它 们 被 部 
署 到 要 启动 进入 的 独立 分 区 然后 使 用 脚本 来 部 署 要 测试 的 镜像 。 这 个 方式 对 于 自动 化 测试 比较 有 用 。 


build-appliance-image: 这 个 菜谱 创建 包含 Yocto 项 目 构建 系统 所 需要 的 所 有 东西 的 Yocto 项 目 构 建 器 具 虚 拟 机 镜像 。 这 个 镜像 可 以 通过 使 用 


VMware Playet 或 者 VMware Workstation 来 启动 。 


学 习 参 考 镜 像 菜 谱 是 学 习 如 何 构建 这 些 镜 像 以 及 什么 包 组 成 了 它们 的 很 好 的 途径 。 核 心 镜像 也 是 用 于 你 自己 的 Linux 操 作 系 统 配 的 好 起 点 。 你 可 以 简 
单 地 通过 添加 包 和 包 组 到 IMAGE_INSTALL 来 轻松 扩展 它们 。 镜 像 仅 仅 可 以 被 扩展 ， 不 能 锌 收缩 。 为 了 构建 具有 更 少 功能 性 的 镜像 ， 你 必须 从 更 小 的 核心 
镜像 开始 并 且 仅 仅 添加 你 需要 的 包 。 没 有 简单 的 方法 来 去 除 包 。 它 们 中 的 大 部 分 是 通过 包 组 来 添加 的 ， 并 且 如 果 你 不 想 安 装 被 包 组 包含 的 包 ， 那 么 你 将 
需要 拆 分 包 组。 当然 ， 如 果 你 正在 去 除 包 ， 那 么 也 必须 去 除 任何 依赖 于 它 的 其 他 包 。 


有 很 多 你 可 以 添加 将 被 包含 在 根 文件 系统 中 的 包 和 包 组 的 方法 。 接 下 来 的 部 分 将 解释 它们 并 提供 为 什么 你 希望 使 用 某 个 方法 而 不 是 其 他 方法 。 


7.1.1 ”通过 本 地 配置 来 扩展 核心 弹 像 


最 简单 的 用 于 增加 包 和 包 组 到 镜像 的 方法 是 增加 IMAGE_INSTALL 到 你 构建 环境 的 conf/local.conf 文 件 中 : 


IMAGE_INSTALL append = " <package> <package group>" 


正如 我 们 已 经 看 到 的 ， 镜 像 菜谱 设置 增加 包 和 包 组 的 IMAGE_INSTALL 变 量 。 为 了 扩展 镜像 ， 你 必须 追加 包 和 包 组 到 这 个 变量 中 。 你 可 能 疑惑 为 什么 
我 们 使 用 显 式 的 append 操 作 符 替代 + = 或 者 .+ 操作 符 。 在 所 有 菜谱 和 配置 文件 已 经 被 处 理 后 ， 使 用 append 操 作 符 无 条 件 地 追加 指定 的 值 到 
IMAGE _ INSTALL 变量 。 镜 像 菜 谱 通常 使 用 = 或 者 ?= 操作 符 来 显 式 地 设置 IMAGE _ INSTALL 变量 ， 这 可 能 发 生 在 BitBake 处 理 了 in conf/local.conf 中 的 设 
置 之 后 。 


例如 ， 增 加 


IMAGE_INSTALL_append = " strace sudo sglite3" 


会 在 根 文件 系统 中 安装 strace 和 sudo 工 具 以 及 SQLite。 当 使 用 append 操 作 符 时 ， 你 必须 要 记 住 企 第 一 个 包 或 者 包 组 的 前 面 增加 空格 ， 因 为 这 个 操 
作 符 不 会 目 动 包含 空格 。 


使 用 在 构建 环境 的 confWlocal.conf 中 的 IMAGE_INSTALL 会 无 条 件 地 影响 你 将 要 用 这 个 构建 环境 所 构建 的 所有 镜像 。 如 果 你 希望 仅 仪 安 半 额外 的 包 
到 特定 镜像 ， 可 以 使 用 条 件 仍 加 : 


IMAGE_INSTALL_append_pn-<image> = " <package> <package group>" 
这 仅仅 向 image 的 根 文 件 系统 安装 指定 的 包 和 包 组 。 例 如 ， 
IMAGE_INSTALL append pn-core-image-minimal = " strace" 


仅仅 向 core-image-minimal 的 根 文件 系统 安装 strace 工 具 。 所 有 其 他 镜像 是 不 受 影 响 的 。 


使 用 IMAGE INSTALL 也 会 影响 核心 镜像 ， 即 从 core-image 类 继承 的 镜像 ， 以 及 直接 从 image 类 继承 的 镜像 。 为 了 便利 性 的 目的 ，core-image 类 定 
义 变 量 CORE IMAGE _EXTRA_INSTALL。 所 有 增加 到 这 个 变量 的 包 和 包 组 都 被 类 追加 到 IMAGE INSTALL, 


使 用 


CORE_IMAGE_EXTRA_INSTALL = "strace sudo sqlite3" 


增加 这 些 包 到 所 有 继承 自 core-image 的 镜像 。 直 接 继 承 自 image 的 镜像 不 受 影响 。 对 于 核心 镜像 来 说 ， 使 用 CORE IMAGE_EXTRA_INSTALL 是 比 直 
接 追 加 到 IMAGE _INSTALL 更 加 安全 和 简单 的 方法 。 


7.1.2 ”用 QEMU 测 试镜 像 
使 用 QEMU 模 拟 器 可 以 很 容易 地 测试 镜像 。 虽 然 你 最 终 是 构建 用 于 产品 的 目标 硬件 的 系统 ， 但 由 于 下 面 的 原因 ， 使 用 QEMU 进 行 测试 有 很 好 的 意 
x, 
- 用 于 启动 QEMU 的 往返 开发 时 间 远 远 快 于 部 署 镜像 到 实际 硬件 中 。 
` 通常 ， 当 软件 开发 开始 的 时 候 ， 硬 件 还 不 可 用 。 
- Yocto 项 目 板 支 持 包 使 得 它 可 以 简单 地 从 QEMU 切 换 到 硬件 ， 然 后 又 切换 回 QEMU。 


在 第 2 章 中 ， 当 执行 我 们 的 第 一 个 构建 时 ， 我 们 使 用 QEMU 来 验证 构建 输出 。Poky 参 考 发 行 版 给 出 了 通过 提供 必要 参数 而 极 大 简化 了 启动 QEUM 任 
务 的 脚本 runqemu。 在 它 最 简化 的 形式 下 ， 用 单一 参数 来 启动 脚本 : 


9 rungemu gemux86 


它 告 诉 脚 本 为 提供 的 QEMU 机 器 定位 最 新 内 核 和 根 文件 系统 镜像 构建 ， 否 则 以 默认 参数 启动 QEMU。 参 数值 与 conf/local.conf 中 的 QEMU 机 器 类 型 
相 匹 配 。 


当 用 不 同 的 根 文 件 系统 镜像 来 工作 时 ， 你 可 能 希望 在 运行 QEMU 之 际 选择 特定 镜像 。 例 如 ， 你 已 经 使 用 前 面 的 命令 行 构建 了 core-image-minimal 
和 core-image-base， 因 为 runqemu 启 动 了 你 最 后 构建 的 任何 镜像 。 使 用 如 下 的 命令 可 选择 镜像 : 


S rungemu gemux86 core-image-minimal 


脚本 自动 选择 正确 的 内 核 并 使 用 最 新 的 core-image-minimal 根 文件 系统 。 为 了 更 多 的 控制 ， 你 可 以 直接 指定 内 核 镜像 和 根 文件 系 统 镜像 文件 : 


S rungemu <path>/bzImage-qemux86.bin <path>/core-image-minimal-qemux86.ext3 


QEMU 和 runqemu 脚 本 是 用 于 快速 往返 应 用 开 妈 的 便利 工具 ， 我 们 将 在 第 11 章 中 探索 它 。 


7.1.3 ”使 用 构建 历史 验证 和 比较 镜像 
当 构 建 产 品 时 ， 你 会 发 现 自己 在 频繁 地 修改 镜像 、 增 加 新 包 以 及 去 除 不 相关 的 包 以 剪裁 内 存 占用 。 使 你 能 够 轻松 验证 和 互相 比较 镜像 构建 的 工具 可 
以 简化 那个 相对 繁重 的 任务 。 


为 了 帮助 维护 构建 输出 质量 并 实现 不 同 构 建 之 间 的 比较 ，BitBake 提 供 构建 历史 ， 由 buildhistory 类 实现 。 这 个 类 在 Git 仓 库 中 记录 关于 被 构建 的 所 有 
包 的 内 容 以 及 关于 被 构建 系统 所 创建 的 镜像 的 信息 ， 你 可 以 从 Git 仓 库 中 检查 它们 。 构 建 历史 默认 情况 下 是 被 禁用 的 。 为 了 启用 它 ， 你 需要 增加 


INHERIT += "buildhistory" 
BUILDHISTORY_COMMIT = "1" 


到 你 构建 环境 的 conf/local.conf 文 件 中 。 请 注意 ，INHERIT 是 你 必须 增加 buildhistory 类 的 变量 。 它 不 同 于 菜谱 和 类 为 从 类 中 继承 功能 性 所 使 用 的 
inherit 指 令 。 每 次 你 做 构建 ，buildhistory 都 会 创建 带 有 变化 的 提交 到 Git 仓 库 。 


buildhistory Git 仓 库存 储 在 由 BUILDHISTORY_DIR 变 量 定义 的 目录 中 。 这 个 变量 的 默认 值 被 设置 成 : 
BUILDHISTORY_DIR ?= "S{TOPDIR}/buildhistory" 


在 启用 buildhistory 和 执行 构建 后 ， 你 将 看 见 被 增加 到 构建 环境 的 顶级 目录 中 的 buildhistory 目 录 。 目 录 包 含 两 个 子 目录 : imagesfilpackages, Bi 
者 包含 关于 你 构建 的 镜像 的 构建 信息 ， 后 者 含有 关于 包 的 信息 。 我 们 将 在 第 13 章 中 分 析 buildhistory Git 仓 库 。 这 里 我 们 仅仅 看 看 images 子 目录 。 在 
images 子 目录 中 ， 镜 像 按 照 目标 机 器 、 目 标 C 库 和 镜像 名 字 而 被 排序 到 进一步 的 子 目录 中 : 


S{TOPDIR} /buildhistory/images/<machine>/<clib>/<image> 
对 于 我 们 使 用 默认 EGLIBC 目 标 库 用 于 qemux86 的 core-image-minimal 构 建 ， 你 将 在 下 面 的 目录 中 找到 镜像 历史 : 
S {TOPDIR} /buildhistory/images/qemux86/eglibc/core-image-mininal 
那个 目录 中 的 文件 给 出 了 关于 什么 组 成 镜像 的 细节 信息 。 
-image-info.txt: 以 最 重要 的 变量 (例如 DISTRO、DISTRO_VERSION 和 IMAGE_INSTALL) 的 形式 表现 的 关于 镜像 的 概览 信息 。 
- installed-packages.txt: 安装 在 镜像 中 的 包 文 件 的 列表 ， 包 括 版 本 和 目标 信息 。 
- installed-package-names.txt: 和 前 面 的 文件 类 似 ， 但 是 仅仅 包括 包 的 名 字 而 没有 版 本 和 目标 信息 。 
- files-in-image.txt: 带 有 目录 名 字 、 文 件 大 小 、 文 件 权 限 和 文件 属 主 的 根 文件 系统 列表 。 


简单 地 搜索 文件 installed-package-names.txt 会 给 你 关于 包 是 否 已 经 被 安装 的 信息 。 


7.1.4 AREI RIA Dik 


增加 包 和 包 组 到 CORE IMAGE _EXTRA_INSTALL 和 IMAGE _ INSTALL 以 及 conf/local.conf 中 可 能 是 非常 简单 和 快速 的 ， 但 是 这 样 做 会 使 项 目 难 以 维 
护 并 且 使 重用 复杂 化 。 更 好 的 方法 是 通过 菜谱 扩展 预定 义 的 镜像 。 程 序 清单 7-2 显 示 扩 展 core-image-base 的 菜谱 。 


程序 清单 7-2 扩展 core-image-base 的 菜谱 


DESCRIPTION = "A console image with hardware support for our IoT device" 
require recipes-core/images/core-image-base.bb 


IMAGE_INSTALL += "Sqlite3 mtd-utils coreutils" 
IMAGE FEATURES = "dev-pkgs" 


例子 包括 用 于 core-image-base 的 菜谱 并 且 增 加 包 到 IMAGE INSTALL， 增 加 镜像 特性 到 IMAGE FEATURES。 我 们 在 接 下 来 的 部 分 解释 镜像 特性 是 
什么 以 及 如 何 使 用 它们 来 定制 镜像 。 

当 用 菜谱 扩展 镜像 时 需要 考虑 的 一 些 事情 是 : 

与 类 不 同 ， 你 需要 提供 相对 于 BitBake 的 层 的 路 径 以 找到 菜谱 文件 来 包含 ， 并 且 需 要 添加 .bb 文件 后 级 。 


- 当 你 使 用 include 或 者 requitre 来 包含 你 正在 扩展 的 菜谱 时 ， 我 们 推荐 使 用 require， 因 为 如 果 BitBake 无 法 定位 到 被 包含 的 菜谱 文件 ， 那 么 它 将 导致 
BitBake 以 显 式 的 错误 消息 退出 。 


- 记 住 使 用 += 操 作 符 来 添加 到 IMAGE_INSTALL 中 。 不 使 用 = 或 者 :=， 因 为 它们 发 盖 由 被 包含 文件 所 定义 的 变量 的 内 容 。 


为 了 让 BitBake 能 够 实际 使 用 这 个 菜谱 作为 构建 目标 ， 你 必须 添加 它 到 通过 conf/bblayers.conf 文 件 包 而 被 包含 进 构建 环境 的 层 中 。 不 建议 添加 菜谱 
到 核心 Yocto 项 目 层 ， 例 如 meta、meta-yocto 以 及 其 他 等 ， 因 为 它 会 使 你 在 升级 到 新 的 Yocto 项 目 版 本 时 难以 维护 构建 环境 。 蔡 代 的 万 式 是 ,创建 在 其 
内 放置 菜谱 的 层 。 


为 菜谱 创建 层 看 起 来 需要 大 量 开销 ， 但 是 几乎 没有 项 目 一 直 保 持 很 小 的 状态 。 以 菜谱 开始 的 项 目 最 终 增长 成 复杂 的 、 上 有 具 有 用 于 镜像 、 包 和 包 组 的 菜 
谱 的 项 目 。 在 第 3 章 中 ， 我 们 介绍 了 yocto-layer， 它 使 得 创建 层 成 为 轻松 的 事 。 


7.1.6 包 组 
在 本 次 创建 定制 Linux 发 行 版 镜像 的 讨论 中 ， 我 们 已 经 数 次 提 到 了 包 组 (package group) 。 包 组 是 被 名 字 引 用 的 包 束 。 在 IMAGE INSTALL 变 量 中 
使 用 那个 名 字 安 装 那个 包 组 定义 的 所 有 包 到 构建 镜像 的 根 文 件 系 统 中 。 


Yocto 项 目 和 OpenEmbedded 核 心 层 定义 通用 的 你 可 以 直接 用 于 镜像 的 包 组 的 集合 。 你 也 可 以 创建 你 自己 的 、 包 含 来 自任 何 层 的 包 的 包 组 ， 包 括 你 
自己 的 层 。 我 们 首先 描述 由 Yocto 项 目 和 OpenEmbedded 核 心 层 所 定义 的 包 组 ， 然 后 研究 关于 包 组 是 如 何 被 定义 的 细节 。 


预定 义 的 包 组 


包 组 是 由 菜谱 定义 的 。 按 照 惯 例 ， 菜 谱 文件 以 packagegroup- 开 头 ， 并 且 放 在 各 自 菜 谱 类 别 的 packagegroup 子 目录 中 。 例 如 ， 你 可 以 在 子 目录 
meta/recipes-qt/packagegroups 中 找到 与 Qt 开 友 框架 相关 的 包 组 菜谱 。 


从 Yocto 项 目 构 建 系 统 的 安 半 目录 中 使 用 


find . -name "packagegroup-*" -print 


会 给 你 用 于 Yocto 项 目 构建 系统 预定 义 的 包 组 的 所 有 包 组 菜谱 列表 。 
以 下 是 最 常见 的 预定 义 的 包 组 : 


packagegroup-core-ssh-dropbear: 提供 因为 其 相对 于 OpenSSH 服 务 器 较 小 的 内 存 占 用 而 常用 于 庶 入 式 系统 的 Dropbear SSH 服 务 器 的 包 。 这 个 


包 组 与 packagegroup-core-ssh-openssh 冲 突 。 在 镜像 中 只 可 以 包含 这 两 者 之 一 。ssh-server-dropbear 镜 像 特性 安装 这 个 包 组 。 


- packagegroup-core-ssh-openssh: 提供 用 于 标准 OpenSSH 服 务 器 的 包 。 这 个 包 组 和 packagegroup-core-ssh-dropbeat 冲 突 。 在 镜像 中 只 可 以 包含 这 


两 者 之 一 。ssh-server-openssh 镜 像 特性 安装 这 个 包 组 。 


- packagegroup-core-buildessential: 提供 最 基本 的 开发 工具 ， 也 就 是 ，GNU Autotools 实 用 程序 autoconf、automake 和 libtool; 包括 链接 器 ld、 汇 


编程 序 as 和 其 他 工具 的 GNU 二 进 制 工具 集 binutils; 编译 器 合集 cpp; gcc; gt+; GNU 国 际 化 和 本 地 化 工具 gettext; make; 带 开发 包 的 libstc++; pkgconfig。 


- packagegroup-core-tools-debug: 提供 最 基本 的 调试 工具 ， 也 就 是 ，GDB 调 试 器 、GDB 远 程 调 试 服务 器 、 系 统 调用 追踪 工具 sttace 以 及 针对 


GLIBC 目 标 库 的 内 存 追 踪 工 具 mtrace。 


- packagegroup-core-sdk: 这 个 包 组 把 packagegroup-core-buildessential 包 组 和 额外 的 用 于 开发 的 工具 (例如 有 具有 shell、 文 件 和 文本 操作 实用 程序 的 
GNU 核 心 实用 程序 ; 动态 链接 器 ldd 等 ) 结合 起 来 。 这 个 包 与 packagegtoup-cote-standalone-sdk-tatget 一 起 构成 tools-sdk 镜 像 特 性 。 


- packagegroup-core-standalone-sdk-target: 提供 GCC 和 标准 C++ 库 。 这 个 包 与 packapgegtoup-cote-sdk 一 起 构成 tools-sdk 镜 像 特 性 。 


- packagegroup-core-eclipse-debug: 提供 GDB 调 试 服务 器 、Eclipse 目 标 通信 框架 代理 和 OpenSSH SFTP 服 务 器 用 于 远程 部 署 和 调试 而 与 Eclipse 
集成 开发 环境 的 集成 。 


- packagegroup-core-tools-testapps: 提供 测试 应 用 程序 进行 测试 ， 例 如 测试 X11 和 中 间 件 包 (如 电话 管理 器 oFono 与 连接 管理 器 ConnMan) o 


tools-testapps 镜 像 特性 安装 这 个 包 组 。 
- packagegroup-self-hosted: 提供 用 于 自 托管 的 构建 系统 的 所 有 必要 包 。build-appliance 镜 像 目 标 使 用 这 个 包 组 。 


- packagegroup-core-boot: 提供 用 于 创建 带 有 控制 台 的 可 启动 镜像 所 必要 的 包 的 最 小 集合 。 所 有 core-image 目标 安装 这 个 包 组 。core-image- 


minimal 仅 仅 安 装 这 个 包 组 和 安装 后 脚本 。 
- packagegroup-core-nfs: 提供 网 络 文件 系统 服务 器 、 实 用 程序 和 客户 端 。nhfs-setvet 镜 像 特 性 安装 这 个 包 组 。 


- packagegroup-base: 这 个 菜谱 提供 互相 依赖 以 及 依赖 于 机 器 和 发 行 版 配置 的 多 个 包 组 。 这 些 包 组 的 目的 是 向 依赖 于 机 器 和 发 行 版 配置 的 镜像 添 
加 硬件 、 联 网 协议 、USB、 文 件 系统 和 其 他 支持 。 两 个 顶级 包 组 是 packagegtoup-base 和 packagegroup-base-extended。 前 者 仅仅 当 机 器 配置 和 发 行 版 配置 都 需 
要 它们 时 才 添 加 对 蓝牙 、WiFi、3G 和 NFC 的 硬件 支持 。 后 者 在 发 行 版 配置 需要 它们 时 也 添加 用 于 那些 技术 的 配置 。 然 而 ， 机 器 配置 不 直接 支持 它们 ， 而 
是 提供 对 PCI、PCMCIA 或 者 USB 主 机 的 支持 。 这 个 包 组 允许 你 创建 带 有 可 以 被 物理 地 添加 到 目标 设备 的 设备 支持 的 镜像 ， 例 如 通过 USB 热 插 找 。 最 常见 
的 是 ， 提 供 硬件 支持 的 镜像 为 了 动态 硬件 支持 而 使 用 packagegroup-base-extended 却 不 是 packagegtroup-base ， 例 如 core-image-base。 


packagegroup-cross-canadian: 使 用 Canadian Cross 技 术 为 创建 工具 链 提供 软件 开发 工具 包 ， 它 在 系统 A 上 创建 一 条 执行 在 系统 B 上 的 工具 链 以 便 
创建 用 于 系统 C 的 二 进 制 。 关 于 这 个 包 组 的 用 例 是 ， 在 构建 系统 上 用 Yocto 项 目 创建 运行 在 镜像 目标 上 但 为 具有 不 同 于 镜像 目标 的 架构 的 第 三 方 系统 产生 
输出 的 工具 链 。 


- packagegroup-core-tools-profile: 提供 例如 oProfile、PowerTOP、LatencyTOP、LTTng-UST 和 Valgrind 的 常见 调试 工具 。tools-profile 镜 像 特性 使 


用 这 个 包 组 。 


- packagegroup-core-device-devel: 提供 用 于 镜像 的 distcc 支 持 。distcc 允 许 在 网 络 上 跨 数 台 机 器 分 发 编译 。distcc 必 须 安 装 、 配 置 并 且 运 行 于 构建 
主机 上 。 在 目标 上 ， 你 必须 定义 交叉 编译 器 变量 来 使 用 distcc 替 代 本 地 编译 器 (例如 expoft CC="distcc") 。 


- packagegroup-qt-toolchain-target: 提供 用 于 在 目标 系统 上 构建 针对 基于 X11 版 本 的 Qt 开发 工具 包 的 应 用 的 包 

- packagegroup-qte-toolchain-target: 提供 用 于 在 目标 系统 上 构建 针对 座 入 式 版 本 的 Qt 开发 工具 包 的 应 用 的 包 
packagegroup-core-qt: 为 使 用 基于 X11 版 本 的 Qt 开发 工具 包 的 目标 系统 提供 所 有 必要 包 

- packagegroup-core-qt4e: 为 使 用 嵌入 式 Qt 开 发 工具 包 的 目标 系统 提供 所 有 必要 包 。gt4e-demo-image 安 装 这 个 包 组 。 
- packagegroup-core-x11-xserver: 仅仅 提供 X.Org X11 RAB. 


- packagegroup-core-x11: 提供 packagegroup-cote-x11-xsetveft 加 上 例如 xhost、xauth、xset、xtandt 的 基础 实用 程序 ， 以 及 启动 时 初始 化 。x11 镜 像 特 


性 安装 这 个 包 组 。 


- packagegroup-core-x11-base: 提供 packagegroup-core-x11 加 上 用 于 工作 的 、 包 括 Matchbox 窗 口 管理 器 、Matchbox 终 端 和 字体 包 的 X11 环境 的 中 间 
件 与 应 用 客户 端 。x11-base 镜 像 特性 安装 这 个 包 组 。 


- packagegroup-core-x11-sato: 提供 用 于 移动 设备 的 OpenedHand Sato 用 户 体 验 ， 它 包括 Matchbox 窗 口 管 理 器 、Matchbox 桌 面 和 大 量 应 用 。x11- 
sato 镜 像 特 性 安装 这 个 包 组 。 为 了 将 这 个 包 组 用 于 目标 镜像 ， 必 须 安 装 packagegroup-cote-x11-base。 


- packagegroup-core-clutter-core: 提供 用 于 Clutter 图 形 化 工具 包 的 包 。 为 了 将 工具 包 用 于 目标 镜像 ， 必 须 安装 packagegtroup-core-x11-base。 


- packagegroup-core-directfb: 提供 用 于 无 X11 的 DirectFB 支 持 的 包 。 这 个 包 组 包括 directfb 和 directfb-example 包 ， 并 且 如 果 由 机 器 配置 所 提供 ， 那 
么 它 将 增加 触摸 屏 支 持 。 


- packagegroup-core-lsb: 提供 所 有 用 于 Linux 标 准 基 支持 的 包 。 
- packagegroup-core-full-cmdline: 通过 安装 完整 的 命令 行 实用 程序 而 不 是 更 加 紧凑 的 BusyBox 变 体 来 为 更 传统 的 Linux 系 统 提供 包 。 


当 解 释 不 同 的 包 组 时 ,我 们 有 点 不 太 严格 地 使 用 术语 提供 (provide) MRR (install) ， 因 为 包 组 荣 谱 实际 上 不 提供 或 者 安 委 任何 包 。 它 们 仅仅 创 
建 会 导致 构 建 系统 处 理 各 个 包 菜 谱 的 依赖 性 ， 正 如 我 们 将 在 下 面 的 部 分 中 看 到 的 。 


包 组 中 的 一 些 是 由 镜像 特性 所 使 用 的 ， 它 引发 了 疑问 : 使 用 镜像 特性 还 是 使 用 镜像 特性 使 用 的 包 组 ? 


包 组 菜谱 


包 组 是 由 继承 自 packagegroup 类 的 菜谱 所 定义 的 。 包 组 菜谱 不 同 于 典型 包 荣 谱 ， 因 为 它们 不 构建 任何 东西 或 者 创建 任何 输出 。 包 组 菜谱 仅仅 创建 
触 友 构建 系统 处 理 包 组 引用 的 包 的 菜谱 的 依赖 性 。 


程序 清单 7-3 显 示 了 典型 的 包 组 菜谱 。 


程序 清单 7-3” 包 组 菜谱 


SUMMARY = "Custom package group for our IoT devices" 
DESCRIPTION = "This package group adds standard functionality required by \ 
our IoT devices." 


LICENSE = "MIT" 


inherit packagegroup 

PACKAGES = "\ 
packagegroup-databases \ 
packagegroup-python \ 
packagegroup-servers" 


RDEPENDS_packagegroup-databases = "\ 
db \ 
sqlite3" 


RDEPENDS_packagegroup-python = "\ 
python \ 
python-sqlite3" 


RDEPENDS_packagegroup-servers = "\ 
openssh \ 
openssh-sftp-server" 


RRECOMMENDS_ packagegroup-python = "\ 
ncurses \ 
readline \ 
zip" 


包 组 菜谱 的 名 字 ， 昌 然 不 是 由 构建 系统 所 强制 或 者 要 求 的 ， 但 也 应 该 遵守 惯例 packagegroup-<name>.bb。 你 也 希望 把 它们 放 在 包 组 集成 的 菜谱 
类 别 的 packagegroup 子 目录 中 。 如 果 包 组 横 跨 菜 谱 并 且 可 能 来 自 多 个 类 别 的 包 组 ， 那 么 把 它们 放 进 recipes-core 类 别 是 好 的 实践 。 


包 组 菜谱 的 基础 结构 相当 简单 。 正 如 任何 菜谱 (我 们 在 第 8 章 中 深入 编写 菜谱 的 细节 ) 应 该 提供 关于 菜谱 做 什么 的 SUMMARY (摘要 ) 一 样 ， 包 组 
菜谱 也 应 该 提供 它 。DESCRIPTION (描述 ) 可 以 提供 更 长 日 更 加 细节 的 解释 ) ， 昌 然 它 是 可 选 的， 但 包括 它 却 是 好 的 实践 。 任 何 菜谱 还 需要 为 菜谱 自己 
提供 LICENSE (许可 ) 。 所 有 包 组 菜谱 都 必须 继承 packagegroup 类 。 


实际 包 组 的 名 字 是 由 PACKAGES 变 量 定义 的 。 这 个 变量 包含 空格 分 隔 的 包 组 名 字 的 列表 。 在 程序 清单 7-3 的 案例 中 ， 它 们 是 packagegroup- 
databases、packagegroup-python 和 packagegroup-servers。 按 照 惯例 ， 包 组 名 字 以 packagegroup- 开 头 。 虽 然 构建 系统 不 要 求 这 么 做 ， 但 是 如 果 
你 坚持 将 它 用 于 你 自己 的 包 组 名 字 ， 那 么 这 会 是 好 的 实践 。 


对 于 每 个 包 组 ， 菜 谱 必须 在 条 件 变量 RDEPENDS <package-group-name> 中 定义 它 的 依赖 性 。 这 些 变量 列 出 需要 的 依赖 性 ， 依 赖 性 可 以 是 包 或 者 


包 组 。 


RRECOMMENDS_<package-group-name> 定 义 是 可 选 的 。 正 如 我 们 在 第 3 章 中 所 看 到 的 ， 推 荐 是 导致 包 仪 仅 在 其 已 经 被 构建 后 才 被 包含 的 弱 依 
赖 。 


你 可 以 从 例如 IMAGE _ INSTALL 的 其 他 变量 中 引用 包 组 ， 当 然 ， 这 会 导致 这 些 包 组 被 安 半 在 目标 镜像 中 。 你 也 可 以 使 用 它们 来 为 层级 结构 的 其 他 包 组 
创建 依赖 性 。 你 必须 避免 包 组 的 循环 依赖 (circular dependencies) 。 这 可 能 听 起 来 很 简单 ， 很 直接 ， 但 是 也 很 容易 在 相当 复杂 的 环境 中 由 于 错误 而 发 
生 。 然 而 ，BitBake 在 循环 包 组 依赖 的 情况 下 以 错误 消息 终止 。 


包 组 菜谱 也 可 以 作为 BitBake 构 建 目 标 而 被 直接 使 用 。 例 如 ， 如 果 包 组 菜谱 的 名 字 是 packagegroup-core-iot.bb， 那 么 你 可 以 使 用 如 下 命令 来 构建 
由 菜谱 定义 的 包 组 的 所 有 包 : 


9 bitbake packagegroup-core-iot 


这 样 做 允许 在 通过 镜像 构建 引用 包 组 之 前 测试 它们 ， 这 样 可 以 简化 调试 。 


7.2 Kit 


7.1 节 详细 说 明了 Yocto 项 目 核心 镜像 以 及 如 何 通过 设置 在 conf/local.conf 和 扩展 预定 义 镜像 菜谱 的 菜谱 中 的 IMAGE INSTALL, 
CORE IMAGE EXTRA INSTALL, IMAGE FEATURES 和 EXTRA IMAGE FEATURES 来 扩展 它们 。 最 终 ， 你 可 能 希望 从 头 创建 定制 Linux 发 行 版 镜像 而 不 
依靠 参考 镜像 。 


定制 镜像 菜谱 必须 继承 image 或 者 core-image 类 。 后 者 本 质 上 是 前 者 的 扩展 并 且 定 义 了 额外 的 镜像 特性 ， 正 如 在 7.1.5 小 节 中 所 摘 述 的 。 选 择 哪 一 个 
用 于 定制 镜像 菜谱 取决 于 需求 。 然 而 ， 继 承 core-image 通 党 是 好 建议 ， 因 为 镜像 特性 是 可 用 的 ,但 是 仅 仪 当 其 被 显 式 地 请 求 时 才 被 安装 。 


程序 清单 7-4 显 示 了 创建 可 局 动 控制 全 镜像 的 最 简单 的 镜像 菜谱 。 
程序 清单 7-4 ”基础 镜像 菜谱 


SUMMARY = "Custom image recipe that does not get any simpler" 
DESCRIPTION = "Well yes, you could remove SUMMARY, DESCRIPTION, LICENSE." 


LICENSE = "MIT" 
inherit core-image 
菜谱 创建 市 有 和 要 局 动 的 核心 包 和 对 目标 设备 的 硬件 广 持 的 镜像 ， 因 为 core-image 类 默认 添加 packagegroup-core-boot 和 packagegroup-base- 


extended 这 两 个 包 组 到 IMAGE INSTALL。 也 由 类 添加 到 IMAGE_INSTALL 的 是 变量 CORE IMAGE_EXTRA_INSTALL， 它 允许 通过 conf/local.conf 进 行 
简单 镜像 修改 ， 如 前 面 所 描述 的 。 


带 有 package-group-core-boot 和 package-base-extended 的 基础 镜像 提供 了 一 个 好 起 点 ， 该 起 点 可 以 简单 地 通过 向 I MAGE_INSTALL 和 
IMAGE_FEATURES 添 加 来 扩展 ， 如 程序 清单 7/-5 中 所 示 。 


程序 清单 7-5 ”向 基础 镜像 添加 


SUMMARY = "Custom image recipe adding packages and features" 
DESCRIPTION = "Append to IMAGE INSTALL and IMAGE FEATURES for \ 
further customization. " 


LICENSE = "MIT" 


# We are using the append operator (+=) below to preserve the default 
# values set by the core-image class we are inheriting. 

IMAGE INSTALL += "mtd-utils" 

IMAGE_FEATURES += "splash" 


inherit core-image 


在 镜像 菜谱 内 ， 使 用 + = 操作 符 直 接 追 加 到 IMAGE_ INSTALL 和 IMAGE _FEATURES。 不 要 在 镜像 菜谱 中 使 用 EXTRA_ IMAGE_FEATURES 或 者 
CORE IMAGE_EXTRA_INSTALL。 这 些 变量 被 保留 以 用 于 conf/local.conf 中 ， 在 conf/local.conf 中 ， 它 们 被 直接 赋值 并 且 履 盖 任 何 由 镜像 菜谱 所 赋 的 
值 。 


不 依赖 用 于 IMAGE_ INSTALL 和 IMAGE_FEATURES 的 默认 值 的 镜像 菜谱 很 简单 ， 如 程序 清单 7-6 所 示 。 


程序 清单 7-6 从头 开始 的 核心 镜像 


SUMMARY = "Custom image recipe from scratch" 
DESCRIPTION = "Directly assign IMAGE INSTALL and IMAGE_FEATURES for \ 
for direct control over image contents." 


LICENSE = "MIT" 


# We are using the assignment operator (=) below to purposely overwrite 

# the default from the core-image class. 

IMAGE INSTALL = "packagegroup-core-boot packagegroup-base-extended \ 
S{CORE_IMAGE_EXTRA_INSTALL} mtd-utils" 

IMAGE_FEATURES = "S{EXTRA_IMAGE FEATURES} splash" 


inherit core-image 


第 一 眼看 来 ， 程 序 清单 7-5 和 程序 清单 7-6 的 镜像 菜谱 是 非常 相似 的 。 事 实 上 ， 这 两 个 菜谱 产生 完全 相同 的 镜像 。 区 别 很 细小 但 是 很 重要 。 程 序 清 
7-5 对 IMAGE INSTALL 和 IMAGE FEATURES 使 用 操作 符 += 来 利用 由 core-image 类 所 提供 的 默认 值 。 程 序 清单 7-6 使 用 赋值 操作 符 = 来 有 目的 地 才 盖 上 默 
认 值 。 


履 善 默认 值 给 了 你 对 镜像 内 容 的 最 大 控制 ， 但 是 你 也 必须 目 己 处 理 基础 。 对 任何 镜像 来 况 ， 你 最 有 可 能 总 是 硕 望 包含 packagegroup-core-boot 来 
获得 可 启动 镜像 。 你 是 否 希 望 packagegroup-base-extended 提 供 的 硬件 支持 依赖 于 需求 。 同 样 由 你 自由 处 置 的 是 CORE_IMAGE_EXTRA INSTALL: 如 
果 你 不 显 式 地 添加 它 到 IMAGE_FEATURES， 那 么 你 将 不 能 在 conf/local.conf 中 使 用 这 个 变量 来 本 地 定制 目标 镜像 ， 但 是 对 于 受 控 的 用 于 生产 的 构建 环 
境 ， 这 么 做 可 能 是 有 意义 的 。 


IMAGE_FEATURES 和 EXTRA_IMAGE_FEATURES 也 是 一 样 的 情况 。 如 果 你 把 赋值 操作 符 用 于 IMAGE_FEATURES 并 且 不 有 意 添 加 
EXTRA IMAGE FEATURES， 那 么 它 是 不 被 包含 的 ， 这 意味 着 debug-tweaks 镜 像 特性 不 会 被 上 应用， 并且 你 需要 提供 用 于 shell 和 SSH 登 录 的 密码 。 和 再 一 
次 ， 这 对 生产 构建 环境 是 有 意义 的 ， 在 其 中 ， 你 不 希望 本 地 设置 覆盖 生产 镜像 的 设置 。 


7.3 ”镜像 选项 


接 下 来 的 部 分 讨论 影响 Yocto 项 目 构建 系统 如 何 创建 根 文 件 系统 镜像 的 选项 。 


7.3.1 ”语言 和 区 域 


通过 增加 IMAGE_LINGUAS 变 量 到 镜像 菜谱 ， 针 对 不 同 领 地 的 额外 语言 可 以 被 简单 地 增加 到 根 文件 系统 或 者 镜像 中 。 使 用 
IMAGE LINGUAS = "en-gb pt-br" 


可 增加 用 于 其 国 英语 和 巴西 葡萄 牙 语 的 特定 语言 包 到 镜像 。 然 而 ， 不 是 所 有 软件 包 都 提供 由 语言 和 领地 分 隔 的 区 域 (设置 ) 。 它 们 中 的 一 些 仅仅 按 
照 语 言 提供 区 域 (locale) 文件 。 在 这 种 情况 下 ， 构 建 系统 默认 成 安 妆 正确 的 语言 本 地 文件 而 不 管 领地 。 


用 于 所 有 包 的 最 小 默认 是 en-us， 它 总 是 会 被 安装 。 另 外 ， 镜 像 类 定义 


IMAGE_LINGUAS ?= "de-de fr-fr en-gb" 


当然 ， 任 何 额外 的 区 域 包 都 会 占用 在 根 文件 系统 镜像 中 的 额外 空间 。 因 此 ， 如 果 设 备 不 需要 任何 额外 语言 支持 ， 在 镜像 菜谱 中 设置 
IMAGE_LINGUAS = "" 


是 好 的 实践 。 


构建 系统 忽略 不 提供 它们 的 包 的 语言 。 


73.2 QER 


构建 系统 可 以 使 用 4 种 不 同 打包 格式 来 打包 软件 包 ，dpkg (Debian Package Management，Debian 包 管理 ) . opkg (Open Package 
Management， 开 放 包 管理 ) 、RPM (Red Hat Package Manager, Red Hat 包 管理 器 ) 和 tar。 仅 有 前 3 种 可 以 用 来 创建 根 文件 系统 。tar 不 提供 必要 
的 元 数据 包 信 息 和 数据 库 来 记录 什么 版 本 的 什么 包 已 经 被 安装 以 及 哪些 包 互 相 冲 突 等 。 


在 构建 环境 的 conf/local.conf 中 的 变量 PACKAGE CLASSES 控制 什么 包 管理 系统 用 于 构建 : 

PACKAGE CLASSES = "package_rpm package_ipk package_tar" 

你 可 以 声明 多 个 打包 类 ， 但 必须 提供 至 少 一 个 。 构 建 系统 为 所 有 被 指定 的 类 创建 包 ; 然而 ， 仪 有 在 列表 中 的 第 一 个 打包 类 被 用 于 创建 友 行 版 镜像 的 
根 文件 系统 。 在 列表 中 的 第 一 个 打包 类 一 定 不 能 是 tar。 


构建 系统 在 tmp/deploy/<pms> 中 的 各 自 目 录 里 存储 由 包 管 理 系统 组 织 的 包 仓库 ，tmp/deploy/<pms> 中 的 <pms> 是 各 自 包 管理 系统 的 名 字 。 在 
那些 目录 中 ， 包 被 进一步 细 分 成 通用 (common) . 2844 (architecture) 和 机 器 依赖 (machine-dependent) 的 包 。 


你 应 该 为 项 目 选择 什么 包 管 理 系统 ”这 依赖 于 项 目的 需求 。 这 里 是 你 可 能 希望 顾及 的 一 些 考虑 : 
. opkg 创 建 并 使 用 比 dpkg 和 RPM 更 少 的 包 元 数据 ， 这 使 得 构建 更 快 并 且 包 更 加 小 。 

. 因为 加 强 的 包 元 数据 ，dpkg 和 RPM 提 供 比 opkg 更 好 的 依赖 性 处 理 和 版 本 管理 。 

RPM 包 管 理 器 是 以 Python 编写 的 ， 并 且 需 要 Python 被 安装 在 目标 上 以 便 在 系统 运行 时 安装 包 。 


默认 情况 下 ， 构 建 系统 不 在 目标 系统 上 安装 包 管 理 器 。 如 果 你 希望 在 伐 入 式 系统 的 运行 时 安装 包 ， 那 么 你 必须 使 用 它 的 镜像 特性 来 增加 包 管 理 器 : 
IMAGE_FEATURES += "package_management" 


(aS ASR EPACKAGE CLASSESAYSS8—T EB Boece EA Sea 


用 于 根 文件 系统 的 包 管 理 系 统 最 终 是 由 变量 IMAGE PKGTYPE 控 制 的 。 这 个 变量 按照 由 PACKAGE CLASSES 定义 的 打包 类 的 顺序 被 自动 设置 ， 在 列 
表 中 的 第 一 个 打包 类 设置 变量 。 我 们 建议 你 不 直接 设置 这 个 变量 。 


73.4 根 文 件 系统 类 型 


最 终 ， 你 使 用 根 文件 系统 镜像 来 为 目标 创建 可 局 动 介质 或 者 局 动 QEMU 模 拟 器 。 为 此 ， 构 建 系统 提供 可 以 为 各 种 文件 系统 类 型 创建 根 文 件 系统 的 


image types 类 。 


镜像 菜谱 不 需要 直接 使 用 image types 类 而 是 将 变量 IMAGE FSTYPES 设 置 成 一 个 或 者 多 个 由 类 提供 的 文件 系统 类 型 。 使 用 
IMAGE FSTYPES = "ext3 tar.bz2" 


创建 两 个 根 文件 系统 镜像 ， 一 个 使 用 ext3 文 件 系 统 ， 一 个 使 用 bzip2 算 法 压缩 的 tar 包 。 


image types 类 定义 变量 IMAGE TYPES， 其 中 包含 你 可 以 在 IMAGE FSTYPES 中 指定 的 所 有 镜像 类 型 的 列表 。 列 表 显示 按照 核心 类 型 排序 的 文件 系 
统 类 型 。 通 常 ， 一 些 核心 类 型 也 以 压缩 的 形式 被 使 用 ， 以 保留 空间 。 如 果 压 缩 算法 被 用 于 文件 系统 ， 那 么 核心 类 型 的 名 字 则 由 压缩 类 型 来 追加 : <core 


name>.<compression type>。 
‘tar, tar.gz, tar.oz2, tar.xz, tar.Iz3: 创建 非 压缩 和 压缩 的 tat 包 形式 的 根 文件 系统 。 
- ext2, ext2.gz, ext2.bz2, ext2.lzma: 使 用 不 带 压 缩 或 者 带 压 缩 的 ext2 文 件 系统 的 根 文 件 系统 镜像 。 
' ext3，ext3.9Z: 使 用 不 带 压 缩 或 者 带 压缩 的 ext3 文 件 系统 的 根 文 件 系统 镜像 。 
btrfs: B 树 文件 系统 的 根 文件 系统 镜像 。 


-jffs2, jffs2.sum: 基于 第 二 代 日 志 闪 存 文件 系统 (the second generation of the Journaling Flash File System, JFFS2) 的 非 压缩 或 者 压缩 的 根 文件 系 
统 。 因 为 第 二 代 日 志 闪 存 文件 系统 直接 支持 NAND 闪 存 设 备 ， 所 以 对 于 说 入 式 设备 来 说 ， 它 是 流行 的 选择 。 它 也 支持 日 志 (journaling) 和 损耗 均衡 


(weat-leveling) 。 


-cramfs: 使 用 压缩 的 ROM 文 件 系统 (cramfs) 的 根 文件 系统 镜像 。Linux 内 核 可 以 挂 载 这 个 文件 系统 而 不 用 先 解 压 。 压 缩 使 用 zlib 算 法 ， 其 一 次 一 页 


地 压缩 文件 以 允许 随机 访问 。 这 个 文件 系统 是 只 读 的 以 便 简 化 它 的 设计 ， 为 带 压 缩 的 随机 写 访问 很 难 实 现 。 
- ISO: 使 用 ISO 9660 标 准 用 于 可 启动 CD-ROM 的 根 文件 系统 镜像 。 这 种 文件 系统 类 型 不 是 独立 的 格式 。 它 使 用 ext3 作 为 底层 文件 系统 类 型 。 
-hddimg: 用 于 可 启动 硬盘 的 根 文件 系统 镜像 。 它 使 用 ext3 作 为 实际 的 文件 系统 类 型 。 


- squashfs, squashfs-xz: 特定 用 于 Linux 的 压缩 的 只 读 根 文件 系统 类 型 ， 与 cramfs 类 似 , 但 是 具有 更 好 的 压缩 性 以 及 对 大 文件 和 文件 系统 的 支持 。 
相 比 于 cramfs 的 固定 的 4KB 块 大 小 ，SquashFS 有 从 0.5KB~64KB 的 可 变 的 块 大 小 ， 它 允许 更 大 的 文件 和 文件 系统 大 小 。SquashFS 使 用 gzip 压 缩 ， 而 squashfs- 
xz 为 了 更 小 的 镜像 而 使 用 Lempel- Ziv - Markov (LZMA) 压缩 。 


-ubi, ubifs: 使 用 非 排序 块 镜像 (Unsorted Block Image, UBI) 格式 的 用 于 原始 闪存 设备 的 根 文件 系统 镜像 。 非 排序 块 镜像 文件 系统 (UBI File 
System, UBIFS) 实质 上 是 JFFS2 的 继承 者 ， 两 者 间 区 别 在 于 前 者 支持 写 缓 存 。 在 IMAGE_FSTYPES 中 使 用 ubifs 仅 仅 创 建 ubifs 根 文件 系统 镜像 。 使 用 ubi 创 
建 ubifs 根 文件 系统 镜像 并 且 运 行 ubinize 实 用 程序 以 创建 可 以 直接 被 写 到 一 台 闪 存 设备 的 镜像 。 


` Cpio，cpio.gz，cpio.xz，cpio.lzma: 使 用 非 压缩 或 者 压缩 的 复制 进出 (Copy in And out, CPIO) 流 的 根 文 件 系 统 镜像 。 
vmdk: 使 用 VMware 虚 拟 机 器 磁盘 格式 的 根 文 件 系 统 镜像 。 它 使 用 ext3 作 为 底层 文件 系统 格式 。 
- elf: 用 来 自 Coreboot 项 目 (www.coreboot.org) 的 mkelfImage 实 用 程序 创建 的 可 启动 根 文件 系统 镜像 。 


再 说 一 次 ， 使 用 什么 镜像 类 型 完全 依赖 于 你 项 目的 需求 ， 特 别 是 依赖 目标 硬件 。 局 动 设备 、 引 导 加 载 程序 、 内 存 限制 和 其 他 因素 决定 什么 根 文 件 系 
统 是 适合 项 目的 。 我 们 的 推荐 是 ， 在 菜谱 中 指定 根 文件 系统 类 型 ext3 和 tar， 或 者 更 好 的 ， 例 如 tar.bz2 的 压缩 格式 。ext3 格 式 允 许 你 为 了 测试 而 用 QEMU 
模拟 器 启动 根 文件 系统 。tar 文 件 系 统 可 以 简单 地 解压 到 被 分 区 和 格式 化 的 介质 上 。 然 后 ， 用 于 目标 硬件 的 机 器 配置 文件 可 以 增加 额外 的 适合 它 的 根 文 件 


系统 类 型 。 


7.3.5 用户、 组 和 密码 


类 extrausers 提 供 了 可 配置 的 用 于 增加 用 户 和 组 到 镜像 以 及 为 用 户 账号 设置 密码 的 机 制 〈( 见 程序 清单 7-8) 。 


程序 清单 7-8 ”修改 用 户 、 组 和 密码 


SUMMARY = "Custom image recipe from scratch" 
DESCRIPTION = "Directly assign IMAGE_INSTALL and IMAGE FEATURES for \ 
for direct control over image contents." 


LICENSE = "MIT" 


# We are using the assignment operator (=) below to purposely overwrite 

# the default from the core-image class. 

IMAGE_INSTALL = "packagegroup-core-boot packagegroup-base-extended \ 
S{CORE_IMAGE EXTRA _INSTALL}" 


inherit core-image 
inherit extrausers 


# set image root password 
ROOT_PASSWORD = "Secret" 
DEV_PASSWORD = "hackme" 
EXTRA USERS PARAMS = "\ 
groupadd developers; \ 
useradd -p ‘openssl passwd ${DEV_PASSWORD}* developer; \ 


useradd -g developers developer; \ 
usermod -p ‘openssl passwd ${ROOT_PASSWORD}° root; \ 


程序 清单 增加 名 为 developers 的 组 和 名 为 developer 的 用 户 账号 ， 并 且 把 用 户 账号 加 到 组 。 它 也 为 root 账 号 修改 密码 。 用 于 增加 和 修改 组 、 用 户 和 
密码 的 命令 被 加 到 变量 EXTRA USERS PARMS 中 ， 其 是 由 类 来 解释 的 。 由 类 理解 的 命令 是 : 


- USeradd: 增加 用 户 账 号 
Usermod: 修改 用 户 账 号 
-userdel: 去 除 用 户 账号 
. groupadd: 增加 用 户 组 
groupmod: 修改 用 户 组 
groupdel: 去 除 用 户 组 


类 执行 具有 相应 名 字 的 各 个 Linux 实 用 程序 。 因 此 ， 选 项 是 完全 相同 的 ， 并 且 可 以 简单 地 在 Linux 手 册页 找到 。 注 意 ， 各 个 命令 之 间 必 须 由 分 号 分 
ba. 
使 用 选项 -p 和 命令 useradd 与 usermod 设 置 用 户 账 号 的 密码 。 密 码 必 须 作 为 密码 散 列 提供 。 你 可 以 手动 计算 密码 散 列 和 增加 它 到 菜谱 ， 或 者 如 例子 


所 示 的 ， 让 菜谱 计算 它 。 


关于 root 用 户 账号 的 一 句 话 : 如 果 debug-tweaks 被 包含 在 IMAGE FEATURES 中 ， 那 么 构建 系统 为 镜像 设置 带 有 空 密码 的 root 用 户 。 去 除 debug- 
tweaks 用 * 疹 换 空 root 密 码 ，* 禁 用 账号 ， 所 以 不 再 可 能 从 控制 台 以 root 登 录 。 对 于 生产 使 用 ， 我 们 强烈 推荐 从 构建 中 去 除 debug-tweaks。 如 果 棒 入 式 
系统 需要 控制 台 登 录 能 力 ， 你 可 以 如 前 面 所 显示 的 设置 root 密 码 ， 或 者 增加 sudo 菜 谱 并 且 设 置 用 户 账号 为 sudoers。 


例如 ， 如 果 你 希望 给 developer 用 户 账号 sudoer 权 限 ， 可 以 简单 地 增加 sudo 到 IMAGE _INSTALL 并 且 增 加 usermod-a-G sudo developer 到 | 
EXTRA USERS PARAMS, 


7.3.6 ”调整 根 文件 系 统 


为 了 在 其 已 经 被 构建 系统 创建 后 和 在 实际 的 根 文 件 系统 镜像 被 创建 前 进一步 地 定制 根 文 件 系 统 ， 可 以 使 用 
ROOTFS_POSTPROCESS COMMAND ( 见 程序 清单 7-9) 。 变 量 包含 由 分 号 分 隔 的 shell 冰 数列 表 。 


程序 清单 7-9 ROOTFS POSTPROCESS COMMAND 


SUMMARY = "Custom image recipe from scratch" 
DESCRIPTION = "Directly assign IMAGE INSTALL and IMAGE FEATURES for \ 
for direct control over image contents." 


LICENSE = "MIT" 


# We are using the assignment operator (=) below to purposely overwrite 
# the default from the core-image class. 


IMAGE_INSTALL = "packagegroup-core-boot packagegroup-base-extended \ 
$ {CORE_IMAGE_EXTRA_INSTALL}" 


inherit core-image 


# Additional root filesystem processing 
modify_shells() { 
printf "# /etc/shells: valid login shells\n/bin/sh\n/bin/bash\n" \ 
> S{IMAGE_ROOTFS}/etc/shells 
} 
ROOTFS_POSTPROCESS_ COMMAND += "modify_shells;" 


该 示例 添加 bash shell 到 /etc/shells。 保 证 总 是 使 用 + = 操作 符 来 添加 到 ROOTFS_ POSTPROCESS COMMAND， 因 为 构建 系统 会 增加 它 自己 的 后 处 
理 命令 到 ROOTFS POSTPROCESS COMMAND, 


sudo 配 置 


如 果 你 遵循 了 前 面 段落 中 关于 给 用 户 sudoer 权 限 的 例子 ， 那 么 你 可 能 注意 到 ， 除 非 你 取消 注释 在 /etc/sudoers 中 的 行 %sudo ALL=(ALL)ALL, ÆN 
它 不 会 工作 。 当 根 文件 系统 镜像 被 创建 时 ， 被 增加 到 ROOTFS POSTPROCESS COMMAND 的 简单 shell 函 数 会 处 理 那个 取消 注释 的 工作 ( 见 程序 清单 7- 
10) 。 


程序 清单 7-10 sudo 配置 


modify_sudoers() { 
sed 's/# %sudo/%sudo/' < S{IMAGE ROOTFS}/etc/sudoers > \ 
S{IMAGE_ROOTFS}/etc/sudoers.tmp 
mv S{IMAGE_ROOTFS}/etc/sudoers.tmp ${IMAGE_ROOTFS}/etc/sudoers 
} 
ROOTFS_POSTPROCESS_ COMMAND += "modify_sudoers;" 


脚本 简单 地 使 用 sed 取 消 注释 行 。 
SSH 服 务 器 配置 


所 有 核心 镜像 自动 包括 用 于 远程 shell 访 问 系统 的 SSH 服 务 器 。 默 认 情 况 下 ， 服 务 器 被 配置 成 用 用 户 名 和 密码 登录 。 使 用 公 钥 基础 设施 (Public Key 
Infrastructure, PKI) 提供 额外 级 别 的 安全 性 但 是 需要 配置 root 服 务 器 和 安 闭 密 钥 到 根 文 件 系统 中 。ROOTFS POSTPROCESS COMMAND 可 以 被 用 来 
简单 地 完成 那个 任务 〈 见 程序 清单 7-11) 。 


程序 清单 7-11 SSH 服 务 器 配置 


configure_sshd() { 
# disallow password authentication 


echo "PasswordAuthentication no" >> S{IMAGE ROOTFS}/etc/ssh/sshd_config 
# create keys in tmp/deploy/keys 
mkdir -p ${DEPLOY_DIR}/keys 
if [ ! -f S${DEPLOY_DIR}/keys/${IMAGE_BASENAME}-sshroot J]; then 
ssh-keygen -t rsa -N ''' \ 
-f ${DEPLOY_DIR}/keys/${IMAGE_BASENAME}-sshroot 
fi 
# add public key to authorized_keys for root 
mkdir -p ${IMAGE_ROOTFS}/home/root/.ssh 
cat ${DEPLOY_DIR}/keys/$ {IMAGE BASENAME}-sshroot.pub \ 
>> S{IMAGE_ROOTFS}/home/root/.ssh/authorized_keys 


} 
ROOTFS_POSTPROCESS_ COMMAND += "configure_sshd;" 


脚本 首先 禁用 用 于 SSH 的 带 有 用 户 名 和 密码 的 认证 。 然 后 它 在 构建 环境 内 部 的 tmp/deploy/keys 中 使 用 根 文件 系统 镜像 的 名 字 (本 质 上 是 镜像 菜谱 
的 名 字 ) 创建 密 钥 对 。 如 果 前 面 的 构建 已 经 创建 了 一 套 密 钥 ， 那 么 它们 将 被 保留 。 最 后 ， 脚 本 增加 公 钥 到 在 通常 用 于 SSH 配 置 的 /home/root/.ssh 中 的 
authorized_keys 文 件 。 用 于 其 他 用 户 的 登录 密 钥 可 以 用 类 似 的 方法 创建 。 


如 果 你 不 要 求 不 同 的 密 钥 用 于 你 构建 的 每 个 设备 ， 那 么 这 种 方法 工作 得 很 好 ， 因 为 根 文件 系统 的 每 个 副本 当然 包含 相同 的 密 钥 。 如 果 你 需要 不 同 的 
密 钥 ,或 者 通常 不 同 的 配置 用 于 设备 ， 那 么 你 需要 为 设备 生产 设计 准备 配置 系统 。 


7A ”上 友 行 版 配置 


构建 系统 为 应 用 到 所 有 被 构建 的 镜像 的 全 局 配置 提供 了 一 种 机 制 。 这 种 机 制 称 为 发 行 版 配置 (distribution configuration) 或 者 发 行 版 策略 
(distribution policy) 。 它 仅仅 是 包含 变量 设置 的 配置 文件 。 发 行 版 配置 是 通过 DISTRO 变 量 设置 而 被 包含 在 构建 环境 配置 文件 conf/local.conf 中 的 : 


DISTRO = "poky" 


变量 设置 对 应 于 其 基础 名 字 与 变量 的 参数 相同 并 且 带 有 文件 后 缀 .conf 的 分 发 配置 文件 。 对 于 前 面 的 例子 ， 构 建 系统 在 折 有 被 构建 环境 包含 的 元 数据 
层 的 子 目录 conf/distro 中 搜索 具有 名 字 poky.conf 的 发 行 版 配置 文件 。 


7.4.1 标准 友 行 版 策略 


Yocto 项 目 提供 了 一 些 用 于 标准 配置 策略 的 发 行 版 配置 文件 : 
Poky: poky 是 用 于 Yocto 项 目的 参考 发 行 版 Poky 的 默认 策略 。 关 于 用 Yocto 项 目 来 开始 和 作为 你 自己 的 发 行 版 配置 文件 的 模板 ， 它 是 个 好 选择 。 


- poky-bleeding: 这 个 发 行 版 配置 基于 poky 但 是 设置 所 有 包 的 版 本 为 最 新 修订 。 它 通常 被 Yocto 项 目 开 发 者 用 于 集成 测试 目的 。 当 然 ， 你 可 以 使 用 
它 ， 但 是 要 知晓 ， 具 有 不 兼容 版 本 的 包 可 能 有 问题 。 


-poky-Isb: 这 个 发 行 版 配置 用 于 符合 Linux 标 准 基 的 栈 。 它 倾向 于 被 使 用 在 cote-image-lsb 镜 像 目 标 和 从 其 衍生 的 镜像 目标 上 。 它 继承 来 自 poky 的 基 
础 设置 并 且 增 加 全 局 配置 设置 以 启用 安全 性 和 包含 由 Linux 标 准 基 遵从 性 所 要 求 的 默认 库 。 


poky-tiny: 这 个 发 行 版 配置 剪裁 设置 以 产生 非常 紧凑 的 、 用 于 蛤 入 式 设备 的 Linux 操 作 系 统 栈 。 它 基于 poky 但 是 提供 仅仅 最 简要 最 小 化 的 必要 功能 
性 以 支持 硬件 和 BusyBox 环 境 。 除 了 仅仅 有 串 行 控制 人 台 之 外 ， 它 不 支持 任何 视频 。 因 为 它 的 精简 配置 ， 只 有 core-image-minimal 镜 像 目标 和 基于 core-image- 
minimal 的 镜像 目标 可 以 用 poky-tiny 发 行 版 配置 来 构建 。 


标准 发 行 版 策略 ， 特 别 是 poky， 是 用 于 你 自己 的 发 行 版 配置 的 展 好 起 点 。 让 我 们 仔细 看 看 poky 发 行 版 配置 以 理解 发 行 版 策略 是 如 何 设置 的 以 及 我 们 
可 以 如 何 将 它们 用 到 我 们 上 自己 的 项 目 中 。 


74.2 ”Poky 发 行 版 策略 


你 可 以 在 构建 系统 的 meta-yocto/conf/distro 目 录 内 找到 包含 Poky 友 行 版 策略 的 文件 poky.conf。 我 们 为 了 方便 把 它 的 内 容 复 制 在 此 ， 重 新 编排 了 
文件 格式 以 适合 页 面 ， 将 变量 设置 分 组 成 逻辑 块 ， 并 且 增 加 了 一 些 注释 ( 见 程序 清单 7-12) 。 


程序 清单 7-12 ”Poky 发 行 版 策略 meta-yocto/conf/distro/poky.conf 


# Distribution Information 


DISTRO = "poky" 

DISTRO_NAME = "Poky (Yocto Project Reference Distro)" 
DISTRO_VERSION = "1.6+snapshot-${DATE}" 
DISTRO_CODENAME = "next" 

MAINTAINER = "Poky <poky@yoctoproject.org>" 
TARGET_VENDOR = "-poky" 


# SDK Information 
SDK_NAME = \ 
"S{DISTRO}-${TCLIBC}-${SDK_ARCH}-${IMAGE BASENAME}-S${TUNE_PKGARCH}" 
SDK_VERSION := \ 
"${@'S{DISTRO_VERSION}'.replace('snapshot-${DATE}', 'snapshot') }" 
SDK_VENDOR = "-pokysdk" 
SDKPATH = "/opt/${DISTRO}/${SDK_VERSION}" 


# Distribution Features 

# Override these in poky based distros 

POKY_DEFAULT_DISTRO_FEATURES = "largefile opengl ptest multiarch wayland" 
POKY_DEFAULT_EXTRA_RDEPENDS = "packagegroup-core-boot" 
POKY_DEFAULT_EXTRA_RRECOMMENDS = "kernel-module-af-packet" 


DISTRO FEATURES ?= "${DISTRO_FEATURES_DEFAULT} ${DISTRO_FEATURES_LIBC} \ 
$ {POKY_DEFAULT_DISTRO_FEATURES}" 


# Preferred Versions for Packages 
PREFERRED_VERSION_linux-yocto ?= "3.14%" 
PREFERRED_VERSION_linux-yocto_gemux86 ?= "3.14%" 
PREFERRED_VERSION_linux-yocto_qgemux86-64 ?= "3.14%" 
PREFERRED _VERSION_linux-yocto_gemuarm ?= "3.14%" 
PREFERRED_VERSION_linux-yocto_gemumips ?= "3.14%" 
PREFERRED_VERSION_linux-yocto_gemumips64 ?= "3.14%" 
PREFERRED_VERSION_linux-yocto_gemuppc ?= "3.14%" 

# Dependencies 


DISTRO_EXTRA_RDEPENDS += " ${POKY_DEFAULT_EXTRA_RDEPENDS}'" 
DISTRO_EXTRA_RRECOMMENDS += " ${POKY_DEFAULT_EXTRA_RRECOMMENDS}" 


POKYQEMUDEPS = "S${@bb.utils.contains( \ 


"INCOMPATIBLE LICENSE", "GPLv3", "", "gemu-config",d) }" 
DISTRO_EXTRA_RDEPENDS_append_gemuarm = " ${POKYQEMUDEPS}" 
DISTRO_EXTRA_RDEPENDS_append_gemumips = " ${POKYQEMUDEPS}" 
DISTRO_EXTRA_RDEPENDS_append_qemuppc = " ${POKYQEMUDEPS}" 
DISTRO_EXTRA_RDEPENDS_append_gemux86 = " ${POKYQEMUDEPS}" 
DISTRO_EXTRA_RDEPENDS_append_qgemux86-64 = " ${POKYQEMUDEPS}" 


# Target C Library Configuration 
TCLIBCAPPEND = "" 


# Target Architectures for QEMU 

# (see meta/recipes-devtools/qemu/gemu-targets.inc) 
QEMU_TARGETS ?= "arm 1386 mips mipsel ppc x86_64" 

# Other QEMU_TARGETS "mips64 mips64el sh4" 


# Package Manager Configuration 
EXTRAOPKGCONFIG = "poky-feed-config-opkg" 


# Source Mirrors 

PREMIRRORS ??= "\ 

DAE ff st an http://downloads.yoctoproject.org/mirror/sources/ \n \ 
araa a? ys" http: //downloads.yoctoproject.org/mirror/sources/ \n \ 
GELA Ia d get http://downloads.yoctoproject.org/mirror/sources/ \n \ 
gitsm://.*/.* http://downloads.yoctoproject.org/mirror/sources/ \n \ 
ala E a ete http://downloads.yoctoproject.org/mirror/sources/ \n \ 
chat ely a a http://downloads.yoctoproject.org/mirror/sources/ \n \ 
pai //.*7 .* http: //downloads.yoctoproject.org/mirror/sources/ \n \ 
SYK ei) a Ta" http://downloads.yoctoproject.org/mirror/sources/ \n \ 
S90 fs 2) a http://downloads.yoctoproject.org/mirror/sources/ \n" 


MIRRORS =+ "\ 

人 http: //downloads.yoctoproject.org/mirror/sources/ \n \ 
me Oe nfa? http://downloads.yoctoproject.org/mirror/sources/ \n \ 
HEtpSt/ fas s* http://downloads.yoctoproject.org/mirror/sources/ \n" 


# Build System Configuration 


# Configuration File and Directory Layout Versions 

LOCALCONF_VERSION = "1" 

LAYER CONF _VERSION ?= "6" 

= 

# OELAYOUT_ABI allows us to notify users when the format of TMPDIR changes 
# in an incompatible way. Such changes should usually be detailed in the 

# commit that breaks the format and have been previously discussed on the 
# mailing list with general agreement from the core team. 

= 

OELAYOUT_ABI = "8" 


# Default hash policy for distro 
BB _SIGNATURE_HANDLER ?= 'OEBasicHash' 


# Build System Checks 
# add poky sanity bbclass 
INHERIT += "poky-sanity" 


# The CONNECTIVITY_CHECK_URIS are used to test whether we can successfully 
# fetch from the network (and warn you if not). To disable the test, set 

# the variable to be empty. 

# Git example url: \ 


git://git.yoctoproject.org/yocto-firewall-test;protocol=git;rev=HEAD 


CONNECTIVITY_CHECK URIS ?= " \ 
https://eula-downloads.yoctoproject.org/index.php \ 
http: //bugzilla.yoctoproject.org/report.cgi" 


SANITY TESTED DISTROS ?= " \ 

Poky-1.4 \n \ 
Poky-1.5 \n \ 
Poky-1.6 \n \ 
Ubuntu-12.04 \n \ 
Ubuntu-13.10 \n \ 
Ubuntu-14.04 \n \ 
Fedora-19 \n \ 
Fedora-20 \n \ 


CentOS-6.4 \n \ 
CentOS-6.5 \n \ 
Debian-7.0 \n \ 
Debian-7.1 \n \ 
Debian-7.2 \n \ 
Debian-7.3 \n \ 


Debian-7.4 \n \ 
SUSE-LINUX-12.2 \n \ 
openSUSE-project-12.3 \n \ 
openSUSE-project-13.1 \n \ 


# OA check settings - a little stricter than the OE-Core defaults 

WARN_QA = "textrel files-invalid incompatible-license xorg-driver-abi \ 

libdir unknown-configure-option" 

ERROR_QA = "dev-so debug-deps dev-deps debug-files arch pkgconfig la \ 
perms useless-rpaths rpaths staticdev ldflags pkgvarcheck \ 
already-stripped compile-host-path dep-cmp \ 
installed-vs-shipped install-host-path packages-list \ 
perm-config perm-line perm-link pkgv-undefined \ 
pn-overrides split-strip var-undefined version-going-backwards" 


在 程序 清单 中 显示 的 文件 来 和 目 撰写 本 书 时 Yocto 项 目 Git 仓 库 的 头 。 取 决 于 你 正在 使 用 什么 版 本 的 Yocto 项 目 工具 ， 这 个 文件 可 能 看 起 来 稍稍 不 同 。 
文件 仅 仪 是 友 行 版 策略 的 例子 。 它 提供 最 常用 地 关联 到 发 行 版 配置 的 变量 设置 。 不 限于 只 是 使 用 显示 在 程序 清单 中 的 设置 ， 如 果 你 的 项 目 不 需 要 它们 ， 
你 也 可 以 去 除 设 置 。 


发 行 版 信息 


这 一 部 分 的 友 行 版 策略 文件 包含 用 于 有 关 友 行 版 的 一 般 信 息 的 设置 。 


‘DISTRO: 发 行 版 的 简称 。 值 必须 匹配 发 行 版 配置 文件 的 基 名 称 。 


- DISTRO _ NAME: 发 行 版 的 长 名 称 。 大 量 菜谱 引用 这 个 变量 。 它 的 内 容 显 示 在 控制 台 局 动 提 示 上 。 


- DISTRO VERSION: 发 行 版 版 本 字符 事 。 它 被 大 量 菜谱 引用 并 且 被 用 在 文件 名 的 发 行 版 制品 中 。 它 显示 在 控制 台 启 动 提示 上 。 


- DISTRO CODENAME: 用 于 发 行 版 的 代码 名 称 。 它 当前 仅仅 被 Linux 标 准 基 菜谱 所 使 用 ， 并 且 被 复制 进 lsb-telease 系 统 配置 文件 中 。 


- MAINTAINER: 发 行 版 维护 者 的 名 字 和 邮件 地 址 。 


- TARGET VENDOR: 用 大 量变 量 (尤其 是 目标 系统 ，TARGET SYS) 连接 的 目标 厂商 字符 串 。ITARGET SYS 是 目标 架构 (TARGET_ARCH) 、 
目标 厂商 (TARGET VENDOR) 和 例如 i586-poky-linux 的 目标 操作 系统 (TARGET_OS) 的 连接 。 这 3 个 部 分 由 连 字符 (-) HAM. TARGET_VENDOR 
字符 串 必须 被 前 组 以 连 字符 ， 而 TARGET _OS 一 定 不 能 被 前 组 以 连 字符 。 这 是 OpenEmbedded 的 很 多 不 幸 的 非 一 致 性 之 一 。 你 可 能 希望 设置 这 个 变量 为 你 
或 者 你 公司 的 名 字 。 


软件 开 友 工具 包 (SDK) 信息 


在 本 部 分 中 的 设置 提供 用 于 软件 开 友 工 具 包 的 基础 配置 。 


-SDK NAME: 构建 系统 用 于 软件 开发 工具 包 输 出 文件 的 基 名 称 。 它 是 通过 用 连 字 符 连 接 DISTRO、TCLIBC、SDK_ARCH、IMAGE_BASENAME 
和 TUNE_PKGARCH 变 量 来 获取 的 。 对 你 来 说 ， 没 有 理由 改变 它 的 默认 设置 字符 串 ， 因 为 它 提供 用 于 区 分 不 同 软件 开发 工具 包 的 所 有 信息 。 


-SDK VERSION: 软件 开发 工具 包 版 本 字符 串 ， 它 通常 被 设置 成 DISTRO_VERSION。 
-SDK VENDOR: 软件 开发 工具 包 厂 商 字 符 串 ， 其 目的 和 TARGET_VENDOR 的 类 似 。 与 TARGET_VENDOR 一 样 ， 字 符 串 必须 被 前 级 以 连 字符 。 


-SDKPATH: 用 于 软件 开发 工具 包 的 默认 安装 路 径 。 软 件 开发 工具 包 人 安装 程序 在 软件 开发 工具 包 的 安装 中 向 用 户 提 供 这 个 路 径 。 用 户 可 以 接受 它 或 
者 输入 替代 的 路 径 。 默 认 值 /opt/${DISTROY/${SDK_VERSION} 安 装 软 件 开发 工具 包 进 入 /opt 系 统 目 录 ， 它 要 求 toot 权 限 。 可 行 的 替代 是 通过 设置 
SDKPATH="${HOME}/${DISTROY/${SDK_VERSION}" 来 安装 软件 开发 工具 包 进 入 用 户 的 家 目录 。 


发 行 版 特性 
这 些 特性 提供 用 于 友 行 版 的 特定 功能 性 。 


DISTRO FEATURES: 为 软件 包 中 的 特定 功能 性 启用 支持 的 发 行 版 特性 列表 。 在 poky.conf 发 行 版 策略 文件 中 的 赋值 包含 
DISTRO_FEATURES_DEFAULT 和 DISTRO_FEATURES_LIBC。 这 两 个 都 包含 默认 发 行 版 特性 设置 。 我 们 将 在 接 下 来 的 两 个 部 分 讨论 发 行 版 特性 ， 它 们 
如 何 工 作 以 及 默认 设置 。 


倾向 的 版 本 
版 本 设置 规定 用 于 包 的 特定 版 本 而 不 是 默认 版 本 。 


- PREFERRED VERSION: 如 果 你 不 希望 使 用 最 新 版 本 ， 那 么 使 用 PREFERRED_VERSION 允 许 为 软件 包 设置 特 定 版 本 ， 因 为 默认 是 最 新 版 本 。 
常用 于 Linux 内 核 ， 但 也 用 于 应 用 软件 对 其 有 强 版 本 依赖 性 的 软件 包 。 


依赖 性 
这 些 设置 是 用 于 上 发行 版 运行 时 所 需要 的 依赖 性 的 声明 。 


-DISTRO_EXTRA_RDEPEND3: 设置 用 于 发 行 版 的 运行 时 依赖 性 。 这 个 变量 声明 的 依赖 性 是 发 行 版 所 需要 的 。 如 果 这 些 依赖 性 不 被 满足 ， 那 么 构 
建 发 行 版 失败 。 


- DISTRO_LEXTRA_RRECOMMENDS: 为 发 行 版 所 推荐 的 用 于 提供 额外 有 用 功能 性 的 包 。 这 些 依赖 性 如 果 是 可 用 的 那么 就 被 增加 ， 但 如 果 它 们 不 被 
满足 ， 构 建 发 行 版 也 不 失败 。 


工具 链 配置 


这 些 设置 配置 用 于 构建 友 行 版 的 工具 链 。 


-TCMODE: 这 个 变量 选择 构建 系统 所 使 用 的 工具 链 。 上 默认 值 是 default， 它 选择 由 构建 系统 构建 的 内 部 工具 链 (gcc、binutils 等 ) 。 变 量 的 设置 对 应 
于 配置 文件 tcmode-${TCMODE}.inc， 构 建 系统 在 路 径 conf/distro/include 中 定位 它 。 这 允许 通过 包含 提供 了 必要 工具 和 配置 文件 的 工具 链 层 来 用 构建 系统 
包含 外 部 工具 链 。 如 果 正 在 使 用 外 部 工具 链 ， 那 么 你 必须 保证 它 是 和 Poky 构 建 系 统 兼 容 的 。 


-TCLIBC: 指定 要 使 用 的 C 库 。 构 建 系统 当前 支持 EGLIBC、uClibc 和 musl。 变 量 的 设置 对 应 于 构建 系统 在 路 径 conf/distto/include 中 定位 的 配置 文件 
tclibc-$fTCLIBC) .inc。 这 些 配 置 文件 为 库 等 设置 倾向 的 提供 者 。 


- TCLIBCAPPEND: 构建 系统 追加 这 个 字符 串 到 其 他 变量 以 按照 C 库 区 分 构建 制品 。 如 果 你 正在 用 不 同 的 C 库 做 实验 ， 那 么 你 可 能 希望 在 发 行 版 配置 
中 使 用 设置 : 


TCLIBCAPPEND = "-S{TCLIBC}" 
TMPDIR .= "${TCLIBCAPPEND}" 


CAST CE Bl IR ZAR BRS. 


镜像 配置 


以 下 设置 为 下 载 源 包 配置 镜像 。 


- PREMIRRORS 和 MIRRORS: Poky 发 行 版 增加 这 些 变 量 来 设置 它 的 镜像 配置 以 使 用 Yocto 项 目 仓 库 作 为 用 于 下 载 的 源 。 如 果 你 希望 使 用 你 自己 的 镜 
像 ， 那 么 你 可 以 增加 它们 到 发 行 版 配置 文件 。 然 而 ， 因 为 镜像 不 是 严格 的 发 行 版 配置 ， 所 以 你 可 能 希望 增加 这 些 变量 到 你 构建 环境 的 local.conf 文 件 中 。 
另 有 替代 是 增加 它们 到 定制 层 的 layet.conhf 文 件 中 。 


构建 系统 配置 
这 些 设 置 定义 用 于 构建 系统 的 需 


-LOCALCONF VERSION: 为 构建 环境 配置 文件 local.conf 设 置 期 望 或 者 要 求 的 版 本 。 构 建 系统 将 这 个 值 和 local.conf 中 CONF_VERSION 变 量 的 值 进 
行 比 较 。 如 果 LOCALCONEF_ VERSION 是 比 CONEF_VERSION 更 新 的 版 本 ， 那 么 构建 系统 可 能 能 够 自动 升级 local.conf 为 更 新 的 版 本 。 和 否则 ， 构 建 系统 以 错 


误 消息 退出 。 


- LAYER CONF VERSION: 为 构建 环境 的 bblayets.conf 配 置 文件 设置 期 望 或 者 要 求 的 版 本 。 构 建 系统 将 这 个 版 本 和 bblayets.conf 设 置 的 
LCONEF VERSION 的 值 进行 比较 。 如 果 LAYER_CONF_VERSION 是 比 LCONEF_ VERSION 更 新 的 版 本 ， 那 么 构建 系统 可 能 能 够 自动 升级 bblayefs.conf 为 更 
新 的 版 本 。 和 否则， 构建 系统 以 错误 消息 退出 。 


-OELAYOUT ABI: 为 输出 目录 TMPDIR 的 布局 设置 期 望 或 者 要 求 的 版 本 。 构 建 系统 在 TMPDIR 内 的 文件 abi_vetsion 中 存储 实际 的 布局 版 本 。 如 果 两 
者 不 兼容 ， 那 么 构建 系统 以 错误 消息 退出 。 这 通常 仅仅 发 生 在 你 正在 使 用 更 新 版 本 的 构建 系统 和 前 面 版 本 所 创建 的 构建 环境 ， 并 且 布 局 不 兼容 地 变化 了 
的 时 候 。 可 删除 TMPDIR 通 过 重新 创建 目录 来 解决 问题 。 


- BB SIGNATURE HANDLER: 签名 处 理 器 签署 共享 状态 缓存 条 目 和 创建 戳记 文件 。 值 引用 因为 其 复杂 度 而 常 以 Python 实现 的 签名 处 理 器 有 函 
数 。 在 meta/lib/oe/sstatesig.py 中 的 代码 实现 了 基于 由 bitbake/lib/bb/sigeen.py 定 义 的 BitBake 签 名 生成 器 SignatureGenetratorBasic 和 SingnatureGeneratorBasicHash 
的 OEBasic 和 OEBasicHash， 并 且 演 示 了 如 何 插 入 你 自己 的 签名 处 理 器 子 数 。 这 两 个 签名 处 理 器 大 部 分 是 相同 的 ， 但 是 OEBasicHash 在 签名 中 包含 任务 代 
码 ， 它 导致 任何 对 元 数据 的 变更 以 使 戳记 文件 和 共享 状态 缓存 条 目 失效 而 不 用 显 式 地 改变 包 的 修订 号 码 。 使 用 DOEBasicHash 的 默认 值 对 于 大 部 分 应 用 来 说 
通常 是 足够 的 。 
构建 系统 检查 
这 些 配 置 变量 控制 各 种 验证 器 来 捕获 构建 系统 配置 错误 。 


- INHERIT+="poky-sanity": 集成 类 poky-sanity， 它 是 执行 构建 系统 检查 所 需要 的 。 推 荐 你 在 发 行 版 配置 文件 中 包含 这 个 指令 。 


- CONNECTIVITY_CHECK URIS: 构建 系统 尝试 验证 网 络 连通 性 的 URI 列 表 。 在 Poky 的 案例 中 ， 这 些 URI 指 向 在 Yocto 项 目的 高 可 用 基础 设施 中 的 文 
件 。 如 果 你 打算 使 用 自己 的 镜像 来 下 载 源 包 ， 那 么 你 可 以 使 用 指向 到 镜像 服务 器 上 的 文件 的 URI 来 验证 正确 的 连通 性 。 


- SANITY_TESTED_DISTROS: Poky 构 建 系统 已 经 在 其 上 测试 过 的 Linux 发 行 版 列表 。 构 建 系统 按照 这 个 列表 验证 它 正 运行 于 的 Linux 发 行 版 。 如 果 那 
个 发 行 版 不 在 列表 中 ，Poky 展 示警 告 消息 并 且 不 加 理会 地 启动 构建 过 程 。Poky 和 运行 在 最 新 的 Linux 发 行 版 上 ， 并 且 在 大 多 数 情况 下 ， 即 使 该 发 行 版 没有 官 
方 支持 ， 构 建 工 作 也 很 好 。 


质量 保证 检查 


质量 保证 (quality assurance) 检查 是 由 meta/classes/insane.bbclass 定 义 和 实 现 的 。 这 个 类 也 定义 包含 在 构建 过 程 中 的 质量 保证 任务 。 质 量 保证 
检查 是 在 配置 、 打 包 和 其 他 构建 任务 之 后 被 执行 的 。 下 面 的 两 个 变量 定义 什么 质量 保证 检查 导致 警告 消息 和 什么 检查 导致 构建 系统 以 错误 消息 终止 构 
建 : 


. WARN QA: 创建 警告 消息 但 是 构建 继续 的 质量 保证 检查 列表 。 
. ERROR QA: 创建 错误 消息 而 且 构 建 终止 的 质量 保证 检查 列表 。 


前 面 的 列表 代表 发 行 版 配置 所 使 用 的 最 常见 的 变量 设置 。 为 了 你 自己 的 友 行 版 配置 ， 按 照 需要 ， 你 可 以 增加 或 省 略 变量 。 


14.3 ”上 友 行 版 特性 


发 行 版 特性 在 软件 包 中 启用 对 特定 功能 性 的 支持 。 增 加 发 行 版 特性 到 变量 DISTRO_FEATURES 会 增加 这 个 特性 的 功能 性 到 在 构建 时 支持 它 的 软件 包 
中 。 例 如 ， 如 果 软 件 包 可 以 被 构建 以 用 于 控制 台 或 者 图 形 用 户 界面 ， 那 么 增加 x11 到 DISTRO_FEATURES 则 会 配置 软件 包 以 使 它 被 构建 成 具有 X11 支持 。 
与 X11 镜像 特性 不 同 ， 这 不 意味 着 X11 包 被 安装 进 目标 根 文件 系统 。 发 行 版 特性 仅 仅 准备 具有 X11 支持 的 包 以 使 它 在 X11 基 包 已 被 安装 的 系统 上 使 用 X11。 


使 用 DISTRO_FEATURES 给 了 你 对 软件 包 如 何 被 构建 的 细 粒 度 的 控制 。 如 果 你 不 需要 特定 的 功能 性 ， 那 么 省 略 启用 它 的 发 行 版 特性 对 特定 软件 包 来 
说 通常 会 产生 更 小 的 内 存 占用 。 


从 构建 系统 的 安 委 目录 使 用 


$ grep -R DISTRO FEATURES * 


给 了 你 使 用 DISTRO_FEATURES 来 条 件 性 地 修改 设置 或 者 构建 过 程 (依赖 于 启用 了 什么 发 行 版 特性 ) 的 全 部 菜谱 和 包含 文件 的 列表 。 

菜谱 通常 使 用 

bb.utils.contains('DISTRO FEATURES', <feature>, <true val>, <false val>) 
ARFAHEDISTRO_FEATURESLAFUBTFEZE ATTIRE A KDISTRO_FEATURESEGAH. X058DISTRO_FEATURES@Sfeature, ABAR ZUR 


true val; 否则 ， 函 数 返回 false_val。 这 使 得 其 对 于 开发 者 向 BitBake 变 量 赋值 或 者 在 if-then-else 语 句 中 使 用 函数 来 说 是 便利 的 。 通 常 它 被 
do_configure 任 务 使 用 以 便 基 于 DISTRO_FEATURES 修 改 配置 。 对 一 些 包 来 阅 ， 它 可 能 向 makefile 提 供 标 记 (flag) 。 


典型 的 例子 是 用 于 构建 EGLIBC 库 的 菜谱 。EGLIBC 人 允许 通过 设置 配置 选项 来 局 用 功能 性 。 文 件 meta/recipes-core/egligc/egilbc-options.inc 是 被 菜 
谱 包 含 的 ， 它 基于 由 DISTRO_FEATURES 提 供 的 发 行 版 特性 来 设置 配置 选项 。 


下 面 的 列表 显示 了 你 可 以 增加 到 DISTRO_FEATURES 以 在 整个 友 行 版 中 全 局 性 地 局 用 软件 包 中 的 功能 性 的 最 常见 友 行 版 特性 。 
dlsa: 启用 对 高 级 Linux 声 卡 架构 (Advanced Linux Sound Architecture, ALSA) 的 支持 ， 包 括 在 可 用 时 安装 开源 兼容 性 模块 。 
- bluetooth: 启用 对 蓝牙 的 支持 。 

-cramfs: 启用 对 压缩 文件 系统 CramFS 的 支持 。 

- directfb: 启用 对 DirectFB 的 支持 。 

EXt2: 为 具有 内 部 大 存储 设备 (例如 硬盘 而 不 仅 是 闪存 设备 ) 的 设备 启用 支持 和 包含 工具 。 
-ipsec: 启用 对 使 用 互联 网 协议 安全 (Internet Protocol Security, IPSec) 的 身份 认证 和 加 密 的 支持 。 
-ipv6: 启用 对 互联 网 协议 版 本 6 (Internet Protocol version 6, IPv6) 的 支持 。 

- irda: 启用 对 如 红外 数据 协会 (Infrared Data Association, IrDA) 所 指定 的 无 线 红外 数据 通信 的 支持 。 
Kkeyboard: 启用 键盘 支持 ， 包 括 在 系统 启动 中 加 载 键盘 布局 。 

nfs: 为 在 系统 上 挂 载 网 络 文件 系统 (NFS) 导出 而 启用 客户 端 网 络 文件 系统 支持 。 


. opengl: 包含 开放 图 形 库 (Open Graphics Library, OpenGL) ， 它 是 用 于 泻 染 2D 和 3D 图 形 的 应 用 程序 编程 接口 。OpenGIL 运行 在 不 同 平 台 上 并 且 


为 大 部 分 常见 编程 语言 提供 绑 定 。 
. pci: 启用 对 PCI 总 线 的 支持 。 
- pcmcia: 启用 对 PCMCIA 和 CompactFlash 的 支持 。 
- ppp: 启用 用 于 拨号 联网 的 点 到 点 协议 (Point-to-Point Protocol, PPP) 支持 。 
smbfs: 为 了 通过 网 络 共享 远程 文件 系统 、 打 印 机 和 其 他 设备 ， 对 微软 的 服务 器 消息 块 (Server Message Block, SMB) 启用 支持 和 包含 客户 。 


-systemd: 包含 对 替代 用 于 启动 和 关闭 系统 的 SysVinit 基 于 脚本 的 系统 的 系统 管理 守护 进程 (system management daemon, systemd) 的 支持 。 


- sysvinit: 包含 对 SysVinit 系 统管 理 器 的 支持 。 

-usbgadget: 启用 对 允许 Linux 设 备 在 被 连接 到 另 一 系统 时 像 USB 设 备 〈 从 角色 ) 一 样 表现 的 Linux-USB Gadget 应 用 编程 接口 框架 的 支持 。 
-usbhost: 启用 允许 例如 键盘 、 和 鼠标、 摄像 头等 被 连接 到 系统 的 USB 端 口 并 且 被 其 检测 到 的 USB 主 机 支持 。 

-wayland: 启用 对 Wayland 合 成 器 协议 (Wayland compositor protocol) 的 支持 并 且 包 含 Weston 合 成 器 。 

Wifi: 启用 WiFi 支 持 。 

- X11: 包含 X11 服务 器 和 库 。 


这 个 程序 清单 不 包含 用 于 C 库 配置 的 发 行 版 特性 。 这 些 发 行 版 特性 都 以 libc- 开 头 。 如 果 C 库 像 Yocto 项 目的 默认 C 库 glibc 一 样 可 配置 ， 那 么 它们 启用 
对 由 C 库 提供 的 功能 性 的 文 持 。 如 果 你 正在 使 用 glibc， 那 么 你 不 必 担 心 设置 这 些 友 行 版 特性 ， 因 为 它们 是 从 默认 友 行 版 设置 中 继承 的 ， 默 认 友 行 版 设置 
将 在 接 下 来 的 部 分 讨论 。 


如 果 你 已 经 工作 于 Yocto 项 目 ， 那 么 你 可 能 已 经 注意 到 ， 其 中 也 有 名 为 MACHINE FEATURES 的 变量 并 且 可 人 允许 的 机 器 特性 列表 和 发 行 版 特性 列表 
有 很 大 的 交集 。 例 如 MACHINE_FEATURES 和 DISTRO_FEATURES 都 提供 特性 bluetooth。 在 DISTRO_FEATURES 中 启用 蓝牙 (Bluetooth) 导致 用 于 硬 
件 支持 的 蓝牙 包 被 安装 并 且 也 为 大 量 软 件 包 启 用 蓝牙 支持 。 然 而 ， 在 MACHINE FEATURES 中 启用 蓝牙 仅仅 导致 用 于 硬件 支持 的 蓝牙 包 被 安装 。 这 给 
你 对 于 机 器 和 发 行 版 级 别 的 功能 性 的 控制 。 在 研究 Yocto 项 目 板 支持 包 时 ， 我 们 会 详细 讨论 机 器 特性 。 


7.44 ”系统 管理 器 


构建 系统 支持 传统 的 基于 脚本 的 系统 管理 器 SysVinit 以 及 系统 管理 守护 进程 (systemd) ，systemd 是 SysVinit 的 替代 ， 它 提供 服务 间 更 好 的 优先 级 
化 和 依赖 性 处 理 以 及 并 行 局 动 服务 的 能 力 以 加 速 启动 序列 。 

SysVinit 是 用 于 由 Poky 构 建 的 Linux 友 行 版 的 默认 系统 管理 器 。 如 果 你 希望 使 用 SysVinit， 那 么 不 必 改 变 配 置 。 

为 了 启用 systemd， 你 需要 增加 它 到 改行 版 特性 并 且 设 置 它 为 系统 管理 器 。 增 加 以 下 命令 到 友 行 版 配置 文件 : 


DISTRO_FEATURES_append = " systemd" 
VIRTUAL-RUNTIME_init_manager = "systemd" 


第 一 行 在 根 文 件 系统 中 安 半 systemd， 第 二 行 局 用 它 作 为 系统 管理 器 。 如 果 sysVinit 也 包含 在 DISTRO_FEATURES 中 ， 那 么 安 半 和 局 用 systemd 不 会 
从 根 文件 系统 中 去 除 SysVinit。 如 果 你 正在 使 用 标准 发 行 版 配置 之 一 ， 例 如 poky， 那 么 你 可 以 用 如 下 配置 来 从 DISTRO_FEATURES 中 去 除 SysVinit: 


DISTRO_FEATURES_BACKFULL_CONSIDERED = "sysvinit" 


它 比 完全 重新 定义 DISTRO_FEATURES 更 加 简单 。 针 对 你 自己 的 发 行 版 配置 ， 当 然 ， 你 可 以 简单 地 从 DISTRO_FEATURES 列 表 中 省 略 SysVinit。 


SysVinit 用 以 局 动 各 个 系统 服务 的 初始 化 脚本 (initscripts) 通 弟 是 提供 服务 的 包 的 一 部 分 。 如 果 你 唯 独 想 使 用 systemd， 那 么 为 了 在 根 文 件 系 统 中 
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VIRTUAL-RUNTIME_initscripts = "" 


来 阻止 构建 系统 安 痊 SysVinit 初 始 化 脚本 。 


一 句 话 警 告 : 一 些 守护 进程 可 能 还 没有 调整 以 用 于 systemd， 因 此 systemd 服 务 文 件 是 不 可 用 的 。 如 果 你 碰 到 这 样 的 软件 ， 你 可 能 不 得 不 自行 做 出 调 
整 。 如 果 你 这 样 做 ， 那 么 请 考虑 向 上 游 (upstream) 提交 工作 。 


TAS 默认 友 行 版 设置 


OpenEmbedded 核 心 元 数据 层 通 过 文件 meta/conf/distro/defaultsetup.conf 和 一 系列 被 它 包含 的 其 他 文件 ( 见 程序 清单 7-13) 来 提供 默认 友 行 
版 设置 。 默 认 发 行 版 配置 如 何 被 包含 进 构 建 环境 不 是 那么 显而易见 的 ， 因 为 这 个 文件 不 是 由 例如 poky.conf 的 发 行 版 策略 文件 所 包含 的 ， 我 们 前 面 讨 论 了 
这 一 点 。 反 而 ， 文 件 是 由 BitBake 的 主要 配置 文件 bitbake.conf 所 包含 的 。 


了 解 defaultsetup.conf 并 理解 其 设置 十 分 重要 ， 因 为 你 自己 的 友 行 版 策略 配置 可 能 扩展 或 者 覆 苹 由 它 提 供 的 一 些 默 认 变 量 设置 。 如 果 你 不 正确 地 设 
置 默 认 友 行 版 ， 那 么 可 能 不 经 意 便 失去 重要 的 默认 设置 ， 并 且 友 行 版 构建 可 能 会 失败 或 者 不 产 出 期 望 的 结果 。 


程序 清单 7-13 ”默认 发 行 版 设置 meta/conf/distro/defaultsetup.conf 


include conf/distro/include/default-providers.inc 
include conf/distro/include/default-versions.inc 
include conf/distro/include/default-distrovars.inc 
include conf/distro/include/world-broken.inc 


TCMODE ?= "default" 
require conf/distro/include/tcmode-${TCMODE}.inc 


TCLIBC ?= "eglibc" 


require conf/distro/include/tclibc-${TCLIBC}.inc 


# Allow single libc distros to disable this code 


TCLIBCAPPEND ?= "-${TCLIBC}" 

TMPDIR .= "S${TCLIBCAPPEND}" 

CACHE = "${TMPDIR}/cache/${TCMODE}-S{TCLIBC}S${@['', '/' + \ 
str(d.getVar('MACHINE', True))][bool(d.getVar('MACHINE', \ 
True))]}${@['', '/' + str(d.getVar('SDKMACHINE', True))] \ 


[bool (d.getVar('SDKMACHINE', True))]}" 


USER CLASSES ?= "* 

PACKAGE_CLASSES ?= "package_ipk" 

INHERIT BLACKLIST = "blacklist" 

INHERIT DISTRO ?= "debian devshell sstate license" 

INHERIT += "S{PACKAGE CLASSES} S{USER_CLASSES} S{INHERIT_DISTRO} \ 
S{INHERIT BLACKLIST}" 


文件 首先 用 默认 设置 包含 3 个 其 他 文件 : default-providers.inc、default-versions.inc 和 default-distrovars.inc。 这 些 文件 的 名 字 对 于 文件 内 容 提供 
什么 是 有 指示 性 的 。 


文件 default-distrovars.inc 特 别 为 DISTRO_FEATURES、DISTRO_FEATURES_DEFAULT、DISTRO_FEATURES_LIBC 和 
DISTRO_FEATURES_LIBC_DEFAULT 提 供 默 认 设 置 。 如 果 你 将 在 友 行 版 策略 配置 文件 中 设置 DISTRO_FEATURES， 那 么 需要 注意 你 没有 不 经 意 地 通过 黎 
盖 变 量 而 去 除 黑 认 设置 。 这 样 做 的 安全 方法 是 ， 使 用 类 似 以 下 的 赋值 : 


DISTRO FEATURES ?= "S{DISTRO FEATURES DEFAULT} S{DISTRO FEATURES LIBC} \ 
S{MY_ DISTRO FEATURES}" 
MY DISTRO FEATURES = "<distro features>" 


其 包含 所 有 默认 设置 并 且 按 需 添加 另外 的 变量 以 包含 额外 的 上 友 行 版 特性 。 


配置 文件 defaultsetup.conf 也 为 TCMODE 和 TCLIBC 设 置 默 认 值 ， 并 且 包 含 它们 各 自 的 配置 文件 ， 正 如 前 面 所 描述 的 。 


7.5 SBE 


在 前 面 几 节 的 例子 中 ， 我 们 使 用 了 OpenEmbedded 核 心 屋 meta 和 Yocto 项 目 基 层 meta-yocto 的 软件 包 和 包 组 。 


随 着 对 Yocto 项 目 和 OpenEmbedded 的 稳定 增长 的 支持 和 贡献 ， 现 在 已 经 有 越 来 越 多 的 额外 层 和 数 百 个 用 于 无 数 软 件 包 的 菜谱 。 它 们 中 的 很 多 被 分 


类 在 OpenEmbedded 网 站 上 。 如 果 你 正在 寻找 菜谱 以 构建 特定 软件 包 ， 那 么 有 可 能 的 是 ， 某 个 人 已 经 做 了 这 个 工作 。 


OpenEmbedded 网 站 的 元 数据 索引 [允许 你 按照 层 、 菜 谱 和 机 器 来 搜索 。 例 如 ， 按 照 层 来 搜索 Java 会 给 你 提供 java 的 层 的 列表 。 按 照 荣 谱 搜索 JDK 
会 给 你 构建 JjDK 包 的 所 有 菜谱 和 提供 该 菜谱 的 层 的 列表 。 


元 数据 率 引 也 人 允许 你 过 滤 出 被 广 持 的 Yocto 项 目 上 友 布 以 看 看 菜谱 或 层 是 否 和 那个 特定 友 布 兼容 。 一 旦 你 友 现 包含 你 正在 寻找 的 软件 包 荣 谱 的 层 ， 所 有 
你 要 做 的 便 是 下 载 屋 、 包 含 其 路 径 到 你 构建 环境 的 conf/bblayers.conf 的 BBLAYERS 变 量 中 以 及 使 用 前 面 描述 的 方法 之 一 增加 期 望 的 软件 包 到 镜像 。 


[1] http://layers.openembedded.org. 


7.6 Hob 


Hob 是 由 Yocto 项 目 提 供 的 用 于 BitBake 的 图 形 用 户 界 面 。 它 是 Yocto 项 目的 子 项 目 乙 一 ， 并 且 是 由 Yocto 项 目 开 及 团队 所 维护 的 。 


为 什么 它 被 称 为 Hob? 在 Hob 的 早期 日 子 里 ， 这 3 个 字母 代表 Human-Oriented Builder (面向 人 的 构建 器 ) 。 然 而 ， 这 听 起 来 真 的 不 够 吸引 人 ， 现 
在 工具 的 名 字 经 党 与 hob (用 于 平底 锅 的 美国 英语 单词 ) 联系 在 一 起 。 那 很 适合 BitBake 和 菜谱 的 方案 。 


借助 Hob， 你 可 以 用 姐 标 而 不 是 编辑 文本 文件 来 便利 地 定制 根 文件 系统 镜像 。 如 果 是 这 样 的 情况 ， 那 么 为 什么 我 们 不 首先 介绍 Hob 而 是 避 易 束 难 地 
解释 如 何 构建 你 自己 的 定制 Linux 发 行 版 ?” 有 以 下 一 些 原因 : 


- 你 可 以 用 Hob 做 很 多 事情 ,但 不 是 所 有 事情 。 


. Hob 是 BitBake 和 构建 环境 的 前 端 。 它 操作 你 构建 环境 中 的 文件 、 启 动 BitBake 并 收集 构建 结果 。 理 解 这 如 何 通 过 手工 完成 可 以 帮助 你 理解 Hob 做 了 什 
么 ， 特 别 是 如 果菜 些 东 西 出 现 错误 的 话 。 


| 虽然 Hob 可 能 隐藏 一 些 复杂 性 ， 但 是 你 仍然 需要 知道 术语 和 特定 变量 设置 如 何 影响 构建 结果 。 
使 用 Hob 相 当 简 单 。 首 先 ， 设 置 构建 环境 ， 然 后 从 它 内 部 启动 Hob: 


S source oe-init-build-env build 
S hob 


Hob 启 动 然后 验证 构建 环境 。 在 那个 检查 完成 后 ， 你 会 看 到 类 似 图 7-1 中 的 屏幕 (我 们 已 经 选择 了 机 器 和 镜像 菜谱 ) 。 


fe 


Image configuration 





图 7-1 Hob 


Hob 用 户 界 面 很 容易 理解 。 


Select a machine: 从 下 拉 菜 单 中 选择 你 希望 为 其 构建 的 机 器 。 列 表 显 示 所 有 包含 在 构建 环境 中 的 任何 层 所 定义 的 机 器 。 选 择机 器 会 改变 在 
con/local.conf 文 件 中 的 MACHINE 变 量 设 置 。 


. Layers: 单 击 这 个 按钮 来 打开 让 你 用 构建 系统 包含 层 和 从 构建 系统 中 删除 它们 的 图 形 化 编辑 器 。 这 样 做 修改 了 构建 环境 中 的 conf/bblayers.conf 文 


Select an image recipe: 从 这 个 下 拉 菜 单 中 ， 你 可 以 选择 你 希望 构建 的 镜像 。 与 执行 bitbake<image-target> 类似， 这 向 BitBake 提 供 了 镜像 目标 。 
菜单 包含 来 自 被 包括 在 你 构建 环境 中 的 所 有 层 的 镜像 目标 。 


- Advanced configuration: 单 击 这 个 按钮 打开 允许 你 选择 根 文件 系统 类 型 、 打 包 格 式 、 发 行 版 策略 、 镜 像 大 小 等 的 菜单 ， 正 如 在 7.3 节 和 7.4 节 所 
简 述 的 。Hob 增 加 这 些 选 项 到 构建 环境 的 conf/local.conf 文 件 中 。 


- Edit image recipe: 在 屏幕 底部 的 这 个 按钮 让 你 通过 增加 或 删除 包 和 包 组 来 修改 镜像 菜谱 。 这 样 做 有 效 地 修改 了 镜像 目标 的 IMAGE_INSTAIL 变 
量 。 然 而 ， 你 不 可 以 从 Hob 用 户 界面 定义 新 的 包 组 。 对 于 那个 任务 ， 你 必须 按照 7.1.6 小 节 所 解释 的 来 编写 自己 的 包 组 菜谱 。 当 然 ， 如 果 你 编写 了 自己 的 包 
菜谱 并 且 用 Hob 包 含 了 其 所 在 的 层 ， 那 么 你 将 能 够 从 包 组 列表 中 选择 它 。 


- Settings: 在 用 户 界 面 右 上 和 角 的 这 个 按钮 允许 你 修改 包含 在 conf/local.conf 中 的 例如 并 行 性 、 下 载 目 录 、 共 享 状态 缓存 、 镜 像 和 网 络 代 理 的 一 般 设 
置 。 使 用 Othets 标 签 ， 可 以 向 conf/local.conf 中 增加 任何 变量 并 且 赋 值 给 它 。 


- Images: 在 Hob 用 户 界 面 右 上 角 靠 近 Settings 按 钮 的 这 个 按钮 显示 前 面 已 构建 的 镜像 的 列表 。 列 表 是 通过 解析 构建 环境 的 
tmp/deploy/images/<machine> 子 目录 来 创建 的 。 你 可 以 从 列表 选择 镜像 ， 如 果 它 是 QEMU 镜 像 就 运行 它 ， 否 则 重新 构建 它 。 


Build image: 这 个 按钮 用 已 选择 的 配置 和 镜像 目标 启动 BitBake。 用 户 界 面 切换 到 构建 视图 的 Log 标 签 ， 从 其 中 你 可 以 遵循 构建 过 程 。 相 对 于 从 命 
令 行 启 动 时 的 BitBake 输 出 ， 这 个 视图 有 主要 的 优势 : 你 不 但 可 以 看 到 当前 正 运行 的 任务 ， 而 且 能 够 看 到 即将 发 生 的 任务 和 已 经 完成 的 任务 。 如 果 有 任何 
构建 问题 、 警 告 或 者 错误 ， 那 么 它们 会 被 记录 在 Issuse 标 签 下 。 在 那里 ， 你 可 以 检查 构建 问题 并 直接 查看 任务 的 完整 日 志文 件 而 不 用 从 构建 环境 目录 结构 
中 导航 。 


在 构建 完成 后 ，Hob 展 示 给 你 一 个 摘要 页 面 ， 在 此 你 可 以 在 构建 系统 的 文件 浏览 器 中 得 看 已 创建 的 文件 。 你 也 可 以 检查 摘要 日 志 ， 该 日 志 显 示 针 对 


每 个 任务 的 运行 结果 以 及 任何 注意 、 警 告 或 者 错误 消息 的 。 如 果 你 使 用 了 Hob 来 为 QEMU 模 拟 器 构建 根 文 件 系统 镜像 和 Linux 内 核 ， 那 么 你 可 以 直接 从 
Hob 中 通过 单 击 在 用 户 界 面 右 下 角 的 Run image 按 钮 来 启动 QEMU 以 验证 镜像 。 从 摘要 页 面 中 ， 你 也 可 以 对 配置 做 修改 并 且 运 行 新 的 构建 。 


相对 于 手动 地 配置 构建 环境 、 定 制 目 标 镜像 和 启动 BitBake， 你 是 否 更 喜欢 用 Hob 完 全 取决 于 你 自己 。 对 于 快速 原型 (rapid prototyping) 以 及 能 
快速 使 不 是 那么 熟悉 BitBake 和 Yocto 项 目的 某 人 来 构建 预定 义 的 根 文 件 系统 镜像 目标 来 说 ，Hob 是 非常 好 的 。Hob 不 允许 你 创建 自己 的 镜像 菜谱 ， 你 也 
不 能 用 它 创 建 自己 的 发 行 版 策略 文件 (或 者 修改 它们 ) 。 对 于 这 些 任务 来 说 ， 你 需要 手动 设置 你 自己 的 层 并 且 创 建 必 要 的 文件 和 菜谱 。 


从 Yocto 项 目 版 本 2.1 以 来 ，Hob 正 在 被 弃 用 而 基于 Web 的 Toaster 开 始 变 得 更 受 欢迎 ， 我 们 将 在 第 13 章 中 详细 研究 它 。 


7.7 BE 


IONA 


Linux 友 行 版 的 最 大 组 成 部 分 是 包含 提供 系统 核心 功能 性 的 大 量 库 和 应 用 的 用 尸 空间 。 本 章 展示 了 关于 Poky 构 建 系统 如 何 创建 根 文件 系统 镜像 和 你 
可 以 如 何 定制 它们 以 满足 需求 的 基础 概念 。 


- OpenEmbedded 构 建 系统 的 核心 镜像 提供 你 可 以 扩展 和 修改 的 发 行 版 蓝图 。 

- 核心 镜像 可 以 通过 追加 包 和 包 组 到 包含 在 变量 IMAGE_INSTALL 中 的 列表 来 轻松 扩展 。 
" QEMU 模 拟 器 是 一 种 便利 和 快速 的 方法 ， 可 在 启动 实际 设备 上 的 根 文件 之 前 测试 它 。 

+ 启用 构建 历史 允许 你 追踪 对 镜像 的 变更 以 及 比较 构建 过 程 的 后 续 执行 。 


创建 你 自己 的 通过 包含 核心 镜像 菜谱 以 在 其 上 构建 的 镜像 菜谱 给 你 提供 了 对 于 根 文件 系统 包含 什么 包 的 更 多 的 控制 。 直 接 继承 core-image 类 的 镜像 
菜谱 允许 你 从 头 构建 根 文 件 系统 镜像 。 


包 组 是 捆绑 多 个 包 和 通过 单一 名 字 引 用 它们 的 机 制 ， 它 用 IMAGE_INSTALL 变 量 极 大 地 简化 了 镜像 定制 化 。Poky 提 供 了 一 系列 组 织 常见 包 的 预定 


义 包 组 。 
. 构建 系统 可 以 以 大 量 输出 形式 生产 根 文件 系统 镜像 。 它 们 中 的 一 些 可 以 直接 写 入 到 例如 闪存 设备 的 存储 介质 中 以 启动 系统 。 
. 设置 发 行 版 策略 允许 独立 于 根 文 件 系 统 内 容 的 操作 系统 配置 。 它 也 提供 了 在 构建 系统 中 使 用 外 部 工具 链 和 改变 C 库 的 方法 。 


- Hob 是 用 于 BitBake 的 图 形 用 户 界 面 。 从 已 初始 化 的 构建 环境 内 部 被 启动 ， 它 允许 配置 和 构建 根 文件 系统 镜像 而 不 用 使 用 文本 编辑 器 来 修改 文件 。 


第 8 章 软件 包 菜谱 


第 7 章 探索 了 如 何 构建 你 自己 的 Linux 操 作 系 统 村 和 创建 根 文件 系统 以 局 动 它们 。 对 于 该 章 中 的 例子 来 说， 我 们 使 用 了 软件 包 ， 并 为 此 将 菜谱 作为 默 
认 元 数据 层 的 一 部 分 来 提供 ， 而 默认 元 数据 层 被 包含 在 OpenEmbedded 构 建 系统 中 。 默 认 包 给 了 你 可 运行 的 Linux 系 统 作 为 用 于 你 上 自己 项 目的 基础 。 它 
们 可 以 如 仅仅 局 动 到 交互 控制 台 的 系统 一 样 简 单 和 基础 ， 也 可 以 如 市 有 提供 用 户 图 形 界 面 的 X 窗 口 系统 (X11) 的 系统 一 样 复杂 。 


除非 你 正在 为 诅 入 式 Linux 工 程 师 构建 开 友 板 ， 否 则 最 终 设备 会 要 求 你 增加 你 自己 的 软件 包 到 操作 系统 栈 。 理 想 的 情况 是 ， 你 希望 BitBake 为 你 构建 
软件 包 并 且 能 够 使 用 在 第 7 草 中 讨论 的 方法 把 它们 包含 在 根 文件 系统 中 。 


本 章 以 展示 构建 软件 包 的 菜谱 的 结构 和 摘 述 被 使 用 的 典型 元 数据 开始 ， 然 后 我 们 显示 如 何 编写 直接 从 C 文 件 构建 的 菜谱 、 用 标准 makefiles 构 建 的 菜 
谱 、 用 CMake 构 建 的 菜谱 以 及 用 GNU Autotools 构 建 的 菜谱 ， 随 后 我 们 解释 各 种 构建 制品 是 如 何 通 过 使 用 包 管 理 系统 来 被 拆 分 成 不 同 包 的 。 我 们 以 关于 
如 何 用 追加 文件 修改 现 有 菜谱 的 部 分 来 结束 本 章 。 


8.1 有 革 畜 布局 和 惯例 


大 部 分 菜谱 被 设计 成 构建 软件 包 。 在 Yocto 项 目 和 OpenEmbedded 惯 例 持续 演进 过 程 中 ， 关 于 如 何 编 写 用 于 软件 包 的 菜谱 的 指导 方针 和 最 佳 实践 已 
经 被 确立 了 。 它 们 不 是 绝对 的 规则 ， 并 且 你 发 现 很 多 菜谱 ， 特 别 是 老 旧 的 菜谱 ， 不 严格 遵守 这 些 指导 方针 。 然 而 ， 社 区 要 向 着 最 佳 实践 靠 扰 ， 并 且 尊 往 
它们 是 很 有 意义 的 。 在 OpenEmbedded 网 站 [1 上 ， 你 可 以 发 现 菜谱 样式 指导 。 


[1] http://openembedded.org/wiki/Styleeuide。 


8.1.1 See SCS 


菜谱 文件 名 遵循 惯例 <packagename> <version>-<revision>.bb， 其 中 packagename 是 菜谱 构建 的 软件 包 的 名 字 。 下 划 线 (_) 把 版 本 字符 串 和 
BEDERAK, EF (-) 把 版 本 字符 串 和 修订 分 隔 开 来 。 不 要 在 菜谱 的 任何 其 他 地 方 使 用 下 划 线 ， 例 如 用 于 分 隔 包 名 的 部 分 。 连 字符 是 被 允许 用 于 包 
名 以 及 包 版 本 的 ， 但 是 对 于 后 者 ， 是 应 该 被 避免 的 。 包 修订 一 定 不 能 包含 连 字 符 。 菜 谱 名 字 的 例子 是 : 


avahi_0.0.31.bb 

- linux-yocto_3.14.bb 

”wpa-supplicant_2.2.bb 

菜谱 文件 名 的 字段 packagename、version 和 revision 分 别 被 BitBake 赋 值 到 变量 PN、PV 和 PR。 


当 包 是 从 软件 配置 管理 (Software Configuration Management, SCM) 系统 的 分 支 中 获取 的 并 且 版 本 没有 与 标签 关联 时 ， 有 关 菜 谱 名 字 的 特定 
问题 出 现 。 在 这 个 情况 下 ， 菜 谱 应 该 被 命名 成 <packagename>_<scm>.bb， 其 中 scm 是 版 本 系统 的 名 字 ， 例 如 git、svn 或 者 cvs。 然 后 ， 菜 谱 应 该 显 式 
地 设置 PV 为 PV="<version>+git${SRCREV}"， 其 中 version 是 最 当前 的 发 布 或 者 标签 点 ， 并 且 SRCREV 指 向 要 从 软件 配置 管理 中 获取 的 修订 。 遵 循 用 于 
菜谱 文件 的 命名 指导 方针 是 十 分 重要 的 ， 因 为 包 名 、 版 本 和 修订 也 被 用 于 包 管 理 系 统 。 使 用 不 正确 的 菜谱 名 可 能 导致 包 管理 器 在 为 目标 根 文件 系统 创 
建 、 安 装 和 维护 包 版 本 时 出 问题 。 


8.1.2 KEP 


菜谱 遵循 标准 布局 以 使 菜谱 文件 更 加 可 访问 和 更 易于 理解 。 这 个 布局 可 以 被 分 解 成 数 个 逻辑 上 分 组 元 数据 的 部 分 。 我 们 使 用 来 自 meta/recipes- 
core/gettext/gettext 0.18.3.2.bb 的 gettext 荣 谱 来 解释 结构 ， 其 显示 在 程序 清单 8-1 中 。 


程序 清单 8-1 gettext 荣 谱 gettext 0.18.3.2.bb 


# Descriptive Meta-data 

SUMMARY = "Utilities and libraries for producing multi-lingual messages" 
DESCRIPTION = "GNU gettext is a set of tools that provides a framework to help 
other programs produce multilingual messages. These tools include a set of 
conventions about how programs should be written to support message catalogs, 
a directory and file naming organization for the message catalogs themselves, 
a runtime library supporting the retrieval of translated messages, and a few 
standalone programs to massage in various ways the sets of translatable and 
already translated strings." 

HOMEPAGE = "http://www.gnu.org/software/gettext/gettext html" 


# Package Manager Meta-data 
SECTION = "libs" 


# Licensing Meta-data 
LICENSE = "GPLV3+ & LGPL-2.1+" 
LIC_FILES_CHKSUM = "file://COPYING;md5=d32239bcb673463ab874e80d47fae504" 


# Inheritance Directives 
inherit autotools texinfo 


# Build Meta-data 
DEPENDS = "gettext-native virtual/libiconv expat" 


仆人 关门 TI ee ee ees! Wee ees eee ees =— s ocean ee re eee 


VDEBPENUS CLass-hatlive = "GeCLUGCAUCrmLinifiai-nialive” 

PROVIDES = "virtual/libintl virtual/gettext" 

PROVIDES_class-native = "virtual/gettext-native" 

RCONFLICTS_$ {PN} = "proxy-libintl" 

SRC_URI = "S{GNU_MIRROR}/gettext/gettext-S{PV}.tar.gz \ 
file://parallel.patch \ 


PACKAGECONFIG[msgcat-curses] = "\ 
--with-libncurses-prefix=$ {STAGING_LIBDIR}/.., \ 
--disable-curses,ncurses," 


LDFLAGS_prepend_libc-uclibc = " -lrt -lpthread " 


SRC_URI[md5sum] = "241aba309d07aa428252c74b40a818ef" 
SRC_URI[sha256sum] = 
"d1a4e452d60eb407ab0305976529a45c18124bd518d97697lac6dc7aa8b4c5d7" 


EXTRA _OECONF += "--without-lispdir \ 
--disable-csharp \ 
--disable-libasprintf \ 
--disable-java \ 
--disable-native-java \ 
--disable-openmp \ 
--disable-acl \ 
--with-included-glib \ 
--without-emacs \ 
--without-cvs \ 
--without-git \ 
--with-included-libxml \ 
--with-included-libcroco \ 
--with-included-libunistring \ 


acpaths = '-I ${S}/gettext-runtime/m4 \ 
-I ${S}/gettext-tools/m4' 


Packaging Meta-data 

these lack the .x behind the .so, but shouldn't be in the -dev package 
Otherwise you get the following results: 

7.4M Angstrom-console-image-glibc-ipk-2008.1-test-20080104-ep93xx.rootfs.tar.gz 
25M Angstrom-console-image-uclibc-ipk-2008.1-test-20080104-ep93xx.rootfs.tar.gz 
because gettext depends on gettext-dev, 

which pulls in more -dev packages: 

15228 KiB /ep93xx/libstdc++-dev_4.2.2-r2_ep93xx.ipk 

1300 KiB /ep93xx/uclibc-dev_0.9.29-r8_ep93xx.ipk 

140 KiB /armv4t/gettext-dev_0.14.1-r6_armv4t.ipk 

4 KiB /ep93xx/libgcc-s-dev_4.2.2-r2_ep93xx.ipk 


+ HF HE HE HE HS HS HF HF HF HF 


PACKAGES =+ "libgettextlib libgettextsrc" 
FILES libgettextlib = "${libdir}/libgettextlib-*.so*" 
FILES libgettextsre = "${libdir}/libgettextsrc-*.so*" 


PACKAGES =+ "gettext-runtime gettext-runtime-dev gettext-runtime-doc" 
FILES S{PN} += "S${libdir}/${BPN}/*" 


FILES _gettext-runtime = "${bindir}/gettext \ 
S{bindir}/ngettext \ 
S{bindir}/envsubst \ 
S{bindir}/gettext.sh \ 
S({iibear}/libasprinti.so™ X 


${libdir}/GNU.Gettext.dll \ 
FILES_gettext-runtime_append_libc-uclibe = " ${libdir}/libintl.so.* \ 
S{libdir}/charset.alias \ 
FILES _gettext-runtime-dev += "S${libdir}/libasprintf.a \ 
S{includedir}/autosprintf.h \ 
FILES_gettext-runtime-dev_append_libc-uclibe = " ${libdir}/libintl.so \ 
S{includedir}/libintl.h \ 
FILES_gettext-runtime-doc = "S${mandir}/manl/gettext.* \ 
S${mandir}/manl/ngettext.* \ 
S{mandir}/manl/envsubst.* \ 
S{mandir}/manl/.* \ 
S{mandir}/man3/* \ 
${docdir}/gettext/gettext.* \ 
$ {docdir}/gettext/ngettext.* \ 
${docdir}/gettext/envsubst.* \ 
${docdir}/gettext/*.3.html \ 
${datadir}/gettext/ABOUT-NLS \ 
S${docdir}/gettext/csharpdoc/* \ 
S{docdir}/libasprintf/autosprintf.html \ 
S{InTOdir}/autosprintts<into \ 


# Task Overrides, Prepends and Appends 
do_install_append() { 
rm -f ${D}S${libdir}/preloadable_libintl.so 


} 
do_install_append_class-native () { 

rm ${D}${datadir}/aclocal/* 

rm ${D}S${datadir}/gettext/config.rpath 

rm ${D}${datadir}/gettext/po/Makefile.in.in 

rm ${D}${datadir}/gettext/po/remove-potcdate.sin 
} 


# Variants / Class Extensions 
BBCLASSEXTEND = "native nativesdk" 


我 们 稍微 重新 格式 化 了 这 个 菜谱 ， 并 且 包 售 了 注释 以 概述 我 们 正在 讨论 的 元 数据 部 分 。gettext 是 包含 你 在 菜谱 中 可 能 遇 到 的 大 部 分 元 数据 的 相当 复 
杂 的 菜谱 。 然 而 ,不 是 所 有 菜谱 都 是 那么 复杂 。 大 部 分 实际 上 是 相当 简单 的 ， 因 为 构建 它们 各 上 自 软件 包 完 全 可 以 被 各 种 类 不 加 任何 太 大 修改 地 完成 。 
接 下 来 的 讨论 解释 菜谱 的 部 分 和 它们 通常 包含 的 元 数据 。 
摘 述 性 元 数据 
描述 性 元 数据 (Descriptive Metadata) 提供 关于 菜谱 和 它 构 建 的 软件 包 的 信息 。 
SUMMARY (摘要 ) : 一 行 (最 多 80 个 字符 长 度 ) ， 包 的 简短 描述 。 
DESCRIPTION (HHR) : 扩展 的 (可 能 多 行 长 度 ) ， 包 和 其 所 提供 的 东西 的 细节 描述 。 


- AUTHOR (作者 ) : 以 AUTHOR="Santa Claus<santa(@notthpole.com>" 形 式 的 软件 包 (不 是 菜谱 ) 的 作者 的 名 字 和 邮箱 地 址 。 这 可 以 是 多 个 作者 的 
列 Ric 


- HOMEPAGE (主页 ) : 以 http:// 开 头 的 URL， 软 件 包 被 托管 在 这 里 。 
- BUGTRACKER (缺陷 姐 路 ) : 以 http:// 开 头 的 URL， 指 向 项 目的 缺陷 追踪 系统 。 
包 管 理 器 元 数据 


在 这 一 部 分 的 元 数据 为 包 管理 系统 提供 主要 用 于 包 数 据 库 (package database) 维护 的 额外 人 信息。 然而， 不 是 所 有 的 包 管理 系统 都 支持 这 些 设 置 。 


- SECTION (部 分 ) : 这 个 包 所 归属 的 类 别 。 包 管理 工具 使 用 这 个 类 别 来 组 织 包 。 虽 然 类 别 未 被 严格 标准 化 并 且 各 种 主流 Linux 发 行 版 定义 它们 自己 
的 列表 ,但 是 通常 被 使 用 的 类 别 已 经 演化 出 来 了 。 常 用 部 分 或 者 类 别 的 例子 是 app、audio、base、devel 和 和 libs。 


PRIORITY (优先 级 ) : 用 优先 级 来 告诉 包 管理 工具 软件 包 是 否 被 系统 运行 需要 ， 以 及 软件 包 是 否 是 可 选 的 或 者 最 终 是 与 其 他 包 冲 突 的 。 优 先 级 仅 
仅 被 Debian 包 管理 器 dpkg 和 开放 包 管 理 器 opkg 所 利用 。 优 先 级 是 : 


- standard (标准 的 ) : 对 任何 Linux 发 行 版 来 说 都 是 标准 的 包 ， 包 括 一 个 相当 小 的 但 是 也 不 太 限制 于 控制 台 模 式 的 系统 。 
.tequited (必要 的 ) : 对 系统 的 正常 功能 来 说 所 必要 的 包 。 
‘optional (可 选 的 ) : 对 可 运行 的 系统 来 说 不 是 必要 的 包 ， 而 是 为 了 合理 可 用 的 系统 的 包 。 
-extra (额外 的 ) : 可 能 与 来 自 更 高 优先 级 的 其 他 包 冲 突 或 者 有 特殊 需求 的 包 。 
许可 元 数据 
这 部 分 的 元 数据 允许 构建 系统 自动 追踪 开源 许可 需求 。 这 个 信息 对 所 有 包 都 是 强制 性 的 。 我 们 将 在 第 12 章 中 人 处理 Yocto 项 目 许 可 管理 的 细节 。 


- LICENSE (许可 ) : 用 于 这 个 软件 包 的 许可 (或 者 多 个 许可 ) 的 名 字 。 在 大 部 分 情况 下 ， 仅 有 一 个 许可 适用 ， 但 是 一 些 开源 软件 包 使 用 多 个 许 
可 。 这 些 可 以 是 允许 包 的 用 户 从 数 个 许可 中 选择 一 个 的 双 许 可 或 者 是 在 软件 包 的 部 分 授权 不 同 的 多 许可 。 双 许可 是 通过 以 管道 符号 〈|) 连接 许可 名 字 来 
指定 的 。 多 许可 是 通过 以 以 连接 许可 名 字 来 指定 的 。 构 建 系 统 也 支持 复杂 的 逻辑 许可 算术 ， 例 如 GLv2& (LGPLv2.1|MPL-1.1|BSD) 。 


-LIC_FILES_ CHECKSUM: 这 个 变量 允许 追踪 对 许可 文件 本 身 的 变更 。 变 量 包 含 、 许 可 文件 以 及 它们 各 自 校 验 和 的 空格 分 隔 列表 。 在 获取 并 解压 了 
软件 包 的 源 文件 后 ， 构 建 系统 通过 对 许可 文件 或 者 许可 文件 的 部 分 计算 校 验 和 ， 以 及 将 其 与 所 提供 校 验 和 进行 比较 来 验证 许可 。 


继承 指令 和 包含 


这 部 分 包含 用 于 菜谱 从 类 继承 功能 性 的 继承 指令 。 它 也 包括 包含 (include) 和 要 求 (require) 语句 以 在 语句 的 位 置 上 直接 插入 其 他 文件 。 在 菜谱 
中 的 位 置 对 于 继承 没有 关系 ,但 是 对 于 包含 文件 ， 它 可 能 是 重要 的 。 被 包含 的 文件 可 以 设置 你 可 能 希望 在 菜谱 中 覆 苹 的 变量 。 


构建 元 数据 
我 们 把 这 部 分 的 元 数据 叫 作 构 建 元 数据 ， 因 为 它 提供 对 于 构建 软件 包 所 需 的 设置 ， 例 如 URI、 声 明 依 赖 性 和 定义 提供 (provisions) 。 
- PROVIDES (提供 ) : 通常 用 于 抽象 配置 的 一 个 或 者 多 个 额外 包 名 的 空格 分 隔 列 表 。 


DEPENDS (依赖 ) : 在 这 个 包 可 以 被 构建 前 必须 被 构建 的 包 名 的 空格 分 隔 列 表 。 


.PN: 包 名 。 这 个 变量 的 值 是 由 BitBake 从 菜谱 文件 的 基 名 称 获 取 的 。 对 大 部 分 包 来 说 ， 这 是 正确 且 足 够 的 。 一 些 包 可 能 需要 调整 这 个 值 。 例 如 ， 交 
又 工具 链 应 | 如 gcc-ctoss， 在 它们 的 名 字 上 被 追加 了 目标 架构 。 





PV: 包 版 本 ， 它 是 由 BitBake 从 菜谱 文件 的 基 名 称 获 取 的 。 对 于 除了 直接 从 源 仓库 构建 的 包 来 说 ， 这 个 值 是 正确 且 足 够 的 。 对 于 那些 从 软件 配置 管 
理 中 构建 的 包 来 说 ，8.1.1 小 节 解 释 了 如 何 正确 设置 PV。 


PR: 包 修 订 。 默 认 修 订 是 :0。 在 过 去 ，BitBake 要 求 你 在 每 次 菜谱 自 己 已 经 改变 了 的 时 候 增 加 修订 以 触发 重新 构建 。 然 而 现在 ， 新 的 签名 处 理 器 计 
算 包 含 函 数 的 菜谱 元 数据 的 签名 。 现 在 ， 构 建 系 统 完全 依赖 于 签名 来 重新 构建 。 


为 了 正确 的 包 命名 ， 增 加 PR 的 值 可 能 仍然 是 必需 的 ， 因 为 其 使 得 包 管理 器 可 以 正确 地 为 包 升 级 维护 数据 库 。 以 前 ， 维 护 是 通过 使 用 PRINC 变 量 来 完 
成 的 。 然 而 ， 这 个 方法 已 经 证 明 是 易于 出 错 的 ， 所 以 PRINC 已 经 被 弃 用 并 且 被 PR service 所 替代 。PR service 是 基于 签名 来 计算 PR 的 修订 服务 器 [1]。 


SRC_URI: 用 于 从 其 下 载 源 代码 、 补 丁 和 其 他 文件 的 URI 空 格 分 隔 列 表 。 
* SRCDATE: 源 代码 日 期 。 这 个 变量 仅仅 当 源 是 从 软件 配置 管理 中 获取 而 来 时 才 适 用 。 


S: 在 构建 环境 中 的 、 构 建 系统 把 未 解压 的 源 代码 放 在 其 中 的 目录 位 置 。 默 认 位 置 依 赖 于 菜谱 名 和 版 本 : ${WORKDIR/${PN}-${PV}. 默认 位 置 
对 于 几乎 所 有 从 文件 包 中 构建 的 包 来 说 都 是 合适 的 。 对 于 直接 从 软件 配置 管理 中 构建 的 包 来 说 ， 你 需要 显 式 地 设置 这 个 变量 ， 例 如 用 于 GIT 人 仓库 的 
${WORKDIR} /git。 


B: 在 构建 环境 中 的 、 构 建 系统 把 在 构建 中 创建 的 对 象 放 入 其 中 的 目录 位 置 。 默 认 是 与 S 相 同 的 : $f{WORKDIRY/${PN}-${PVY。 很 多 软件 包 是 在 树 
(in tree) 中 或 者 在 位 置 (in location) 中 被 构建 的 ， 把 对 象 放 在 源 树 中 。 用 GNU Autotools 来 构建 包 的 菜谱 、Linux 内 核 和 交叉 工具 链 应 用 分 离 源 和 构建 目 


FILESEXTRAPATHS: 扩展 用 于 由 FILESPATH 定 义 的 额外 本 地 文件 的 构建 系统 的 搜索 路 径 。 这 个 变量 最 常 MFILESEXTRAPATHS_prepend: 
="${THISDIR}/${PN}" 形 式 被 用 于 追加 文件 中 ， 它 导致 构建 系统 在 由 FILESEXTRAPATHS 指 定 的 其 他 目录 中 查找 之 前 先 在 带 有 追加 文件 存在 于 其 中 的 目 
录 的 包 名 的 子 目 录 中 寻找 额外 文件 。 


PACKAGECONFIG: 这 个 变量 允许 在 构建 时 启用 和 禁用 软件 包 的 特性 。 你 用 以 下 形式 的 四 们 列表 (quadruples of lists) 定义 特性 : 


PACKAGECONFIG[f1] = "--with-f1,--wo-f1,build-deps-f1,rt-deps-f1" 
PACKAGECONFIG[f2] = "--with-f2,--wo-f2,build-deps-f2,rt-deps-f2" 
PACKAGECONFIG[£3] = "--with-f3,--wo-f3,build-deps-f3,rt-deps-f3" 


四 倍 是 用 逗号 () 分 隅 的 。 它 们 的 顺序 很 重要 : 

1. 如 果 特 性 是 被 启用 的 ， 额 外 参数 加 到 configure 脚 本 (EXTRA_OECONF) 的 配置 列表 。 
2. 如 果 特 性 是 被 禁用 的 ， 额 外 参数 加 到 EXTRA_OECONF。 

3. 如 果 特 性 是 被 启用 的 ， 额 外 构建 依赖 性 加 到 DEPENDS。 

4. 如 果 特性 是 被 启用 的 ， 额 外 运行 时 依赖 性 加 到 RDEPENDS。 

为 了 启用 特性 ， 你 可 以 创建 追加 文件 或 者 在 配置 文件 中 这 样 做 : 


追加 文件 : 在 你 自己 的 层 中 创建 追加 文件 并 且 命 名 它 为 <packagename>.bbappend， 其 中 packagename 是 你 希望 追加 的 菜谱 名 ， 然 后 你 可 以 通过 用 
PACKAGECOMFIG="f2 f3" 窗 盖 它 们 来 完全 重新 定义 变量 或 者 你 可 以 用 PACKAGECONFIG_append="f2 f3" 来 保留 原来 的 设置 值 。 


配置 文件 : 你 可 以 简单 地 使 用 PACKAGECONFIG_pn-<packagename>="f2 f3" 或 者 PACKAGECONFIG_append_pn-<packagename>="f2 £3" RY Au X 
量 到 如 localconf 的 配置 文件 或 者 发 行 版 配置 文件 。 


这 两 个 方法 在 结果 上 是 完全 相同 的 。 
- EXTRA OECONF: 额外 的 configure 脚 本 选项 。 
EXTRA OEMAKE: 用 于 GNU Make 的 额外 选项 。 
EXTRA OECMAKE: 用 于 CMake 的 额外 选项 。 


- LDFLAGS: 传 到 链接 器 的 选项 。 默 认 设 置 依赖 于 构建 系统 在 构建 什么 : 当 为 目标 构建 时 ， 它 是 TARGET_LDFLAGS; 当 为 构建 主机 构建 时 ， 它 是 


BUILD_LDFLAGS; 当 为 主机 构建 SDK 时 ， 它 是 BUILDSDK_LDFLAGS。 你 通常 不 完全 履 盖 这 个 变量 而 是 向 其 增加 选项 。 


-PACKAGE ARCH: 定义 软件 包 的 架构 。 黑 认 情 况 下 ， 当 为 目标 构建 时 ， 这 个 变量 被 设置 成 TUNE_PKGARCH; 当 为 构建 主机 构建 时 ， 这 个 变量 
被 设置 成 BUILD_ARCH; 当 构 建 SDK 时 ， 这 个 变量 被 设置 成 %{SDK_ARCHY-${SDKPKGSUFPIX}"。 默 认 值 通常 是 足够 的 ， 除 非 你 的 软件 包 完全 依赖 于 特 


定 的 机 器 而 不 是 依赖 于 机 器 的 架构 。 在 这 种 情况 下 ， 要 在 菜谱 中 设置 PACKAGE_ARCH='"${MACHINE_ARCH}”"。 
打包 元 数据 


菜谱 的 这 个 元 数据 部 分 定义 构建 输出 如 何 使 用 包 管 理 器 被 打包 进 不 同 的 包 中 。 打 包 发 生 在 软件 已 经 被 构建 并 且 被 安装 进 包 构 建 目录 本 地 的 根 文 件 系 
统 结 构 之 后 。 我 们 在 此 介绍 变量 并 且 在 接 下 来 的 部 分 讨论 细节 。 


- PACKAGES: 这 个 变量 是 在 打包 过 程 中 被 创建 的 包 的 空格 分 隔 列 表 。 这 个 变量 的 默认 值 是 "${PN}-dbg$ {PN}-staticdev$ {PN} -dev$ {PN} -doc$ {PN}- 
locale\${PACKAGE_BEFORE_PN}${PN}"。 这 个 列表 是 以 从 左 到 右 的 方式 来 被 处 理 的 ， 意 味 着 ， 最 左 侧 的 包 首 先 被 创建 ， 最 右 侧 的 包 最 后 被 创建 。 顺 序 
是 重要 的 ， 因 为 包 消 耗 与 它 相关 联 的 文件 。 如 果 两 个 或 者 更 多 包 消 耗 相同 的 文件 ， 那 么 仅仅 第 一 个 被 处 理 的 包 包 含 文件 。 菜 谱 通常 把 额外 包 增 加 到 列表 
的 前 部 。 





- FILES: FILES 变 量 定 义 被 放 进 特定 包 中 的 目录 和 文件 的 列表 。 构 建 系 统 为 实际 的 包 定 义 默 认 文 件 和 目录 列表 ， 例 如 FILES_${PN}-dbg="<files>"， 


其 中 fles 是 空格 分 隔 的 可 以 包含 通配符 的 目录 和 文件 列表 。 如 果菜 谱 增加 额外 包 到 PACKAGES 中 的 列表 ， 那 么 你 需要 为 那个 包 定 义 FILES。 菜 谱 可 能 产生 
通常 未 在 默认 包 中 被 发 现 的 对 象 ， 你 希望 将 其 增加 到 标准 包 。 在 那个 情况 下 ， 你 要 用 带 有 那些 文件 的 列表 追加 到 FILES。 


- PACKAGE BEFORE PN: 这 个 变量 让 你 在 最 终 的 包 名 被 创建 前 简单 地 增加 包 。 你 可 以 简单 地 看 到 其 如 何 工作 。 在 PACKAGES 的 默认 列表 


中 ，PACKAGE_BEFORE_PN 交 量 的 内 容 在 最 终 的 包 PN 之 前 被 扩展 。 简 单 地 增加 包 到 变量 PACKAGE_BEFORE_PN="${PN}-examples"。 当 然 ， 你 也 需要 








为 examples 包 定义 FILES 列 表 。 
PACKAGE DEBUG SPLIT STYLE: 这 个 变量 决定 当 ${PN}-dgb 包 被 创建 时 如 何 拆 分 二 进 制 和 调试 对 象 。 有 3 个 变 体 : 


"debug": 在 目标 上 ， 包 含 调试 符号 的 文件 被 放 在 安装 有 二 进 制 的 目录 内 的 .debug 目 录 中 。 例 如 ， 如 果 二 进 制 被 安装 在 /ust/bin 中 ， 那 么 调试 符号 文 
件 被 置 于 /ust/bin/.debug。 这 个 选项 也 在 .debug 中 安装 源 文 件 ， 它 是 默认 行为 。 


"debug-file-directory": 在 目标 上 ， 调 试 文件 被 放 在 /ust/lib/debug 下 面 ， 将 其 和 二 进 制 分 开 。 
- "debug-without-stce": 这 个 变 体 和 .debug 一 样 ， 但 是 源 文 件 不 被 安装 。 


PACKAGESPLITFUNCS: 这 个 变量 定义 执行 包 拆 分 的 辑 数 的 列表 。 由 package.bbclass 定 义 的 默认 是 PACKAGESPLITFUNCS? 


="package_do_split_locales populate_packages"。 菜 谱 可 以 前 新 增 到 这 个 变量 以 在 该 默认 被 运行 前 运行 它们 自己 的 包 分 离 函 数 。 


任务 覆 藉 、 前 新 增 和 追加 


TXB, KEBEK, MESAS (prepend) 和 追加 以 重新 定义 、 变 更 或 者 扩展 默认 行为 。 


变 体 /类 扩展 


这 个 部 分 简单 地 包含 BBCLASSEXTEND 变 量 以 创建 例如 包 的 原生 或 者 软件 开 友 工具 包 构 建 的 变 体 。 


运行 时 元 数据 


这 个 元 数据 部 分 定义 运行 时 依赖 性 。 


. RDEPENDS: 该 包 在 运行 时 所 依赖 的 ， 为 了 该 包 正确 运转 而 必须 被 安装 的 包 列表 。 变 量 适用 于 正在 被 构建 的 包 ， 因 此 对 特定 包 ， 你 需要 条 件 性 地 
定义 它 。 例 如 ， 如 果 开 发 包 依赖 Per 以 正确 运行 ， 那 么 你 需要 指定 RDEPENDS_$fPN]}-dev+="petl"， 它 告诉 构建 系统 在 包 管理 器 的 程序 清单 中 创建 这 个 包 
依赖 性 。 


" RRECOMMENDS: 与 RDEPENDS 类 似 但 是 指示 弱 依 赖 性 ， 因 为 这 些 包 对 于 正在 被 构建 的 包 不 是 必 不 可 少 的 。 然 而 ， 它 们 确实 增加 可 使 用 性 。 如 
果 这 些 包 是 可 用 的 ， 那 么 包 管 理 器 安装 它们 ; 但 如 果 这 些 包 是 不 可 用 的 ， 那 么 包 管 理 器 也 不 失败 。 


- RSUGGESTS: 与 RRECOMMENDS 类 似 ， 但 是 从 即使 这 些 包 是 可 用 的 但 是 包 管 理 器 也 不 安装 它们 的 这 个 意义 上 来 说 ， 其 黄 至 更 加 弱 。 它 们 仅仅 提 
供 这 样 的 信息 一 一 安装 这 些 包 可 能 是 有 好 处 的 。 


-RPROVIDE>: 用 于 运行 时 配置 的 包 名 别名 列表 。 包 的 自 有 名 字 总 是 隐 式 地 作为 那个 列表 的 一 部 分 。 正 如 对 于 控制 包 创 建 的 所 有 运行 时 元 数据 一 
样 ， 你 需要 使 用 条 件 赋值 : RPROVIDES_${PN}="alias1 alias2"。 


- RCONFLICTS: 冲突 包 的 名 字 列 表 。 如 果 在 安装 前 不 是 所 有 冲突 包 都 被 移 除 了 ， 那 么 包 管 理 器 不 安装 这 个 包 。 正 如 对 于 控制 包 创 建 的 所 有 运行 时 
元 数据 一 样 ， 你 需要 使 用 条 件 赋值 : RCONFLICTS_${PN}="conflicting-package-name". 


- RREPLACES: 这 个 包 替 代 的 包 的 名 字 列 表 。 包 管理 器 使 用 这 个 变量 来 决定 这 个 包 替 换 其 他 哪些 包 。 如 果 包 可 以 共存 ， 那 么 包 管 理 器 多 
即使 在 这 个 列表 的 其 他 包 是 被 安装 的 。 如 果 包 不 能 共存 ， 那 么 该 包 必 须 也 设置 RCONFLICTS 变 量 来 包含 那些 包 。 正 如 对 于 控制 包 创建 的 所 有 :; 
据 一 样 ， 你 需要 使 用 条 件 赋 值 : RCONFLICTS_${PN}="conflicting-package-name"。 构 建 系统 支持 版 本 化 的 依赖 性 : 


$ 
涉 
bi 
> 
S g 


bi 


RDEPENDS_S${PN} = "<package> (<operator> <version>)" 
这 里 的 操作 符 是 =、<、>、< = 或 者 >= 之 一 。 例 如 ， 


RDEPENDS_S{PN} = "gettext (> 0.16)" 


你 可 以 在 RDEPENDS、RRECOMMENDS、RSUGGESTS、RCONFLICTS 和 RREPLACES 中 使 用 版 本 化 的 依赖 性 。 


[1] 默认 情况 下 ，PR service 是 被 禁用 的 。 关 于 更 多 信息 以 及 如 何 启 用 它 ， 请 参见 在 https://wiki.yoctoproject.oreg/wiki/PR_Service 的 PR service wiki. 


8.1.3 ”格式 指导 万 针 


用 于 源 代码 、BitBake 菜 谱 和 类 的 格式 指导 方针 本 质 上 是 源 代码 。 它 们 的 目的 是 跨 所 有 制品 创建 一 致 的 格式 和 人 外观 以 便 某 个 正在 尝试 工作 于 Yocto 项 
目 和 OpenEmbedded 的 人 可 以 快速 学 习 和 和 理解。 指导 方 针 也 简化 审查 维护 者 的 贡献 。 


OpenEmbedded 已 经 建立 了 样式 指导 [1， 它 确立 了 用 于 格式 菜谱 、 类 和 配置 文件 的 基础 规则 : 
赋值 
. 在 赋值 操作 符 的 每 一 侧 使 用 单一 的 空格 。 


` 仅仅 在 赋值 的 右手 侧 使 用 引号 : 


VARIABLE = "VALUE" 


` 为 了 更 好 的 可 阅读 性 ， 延 续 被 用 来 拆 分 长 的 变量 列表 ， 例 如 SRC_URI。 

` 使 用 行 延续 符号 (\) 。 

+ 不 在 行 延续 符号 后 面 放置 任何 空格 。 

+ 缩 进 连 续 的 行 到 值 开头 的 水 平 。 

:为 缩 进 使 用 空格 替代 tab， 因 为 开发 者 倾向 于 不 相同 的 设置 它们 的 tab 大 小 。 


把 结束 的 引号 放 在 它 自己 的 行 上 。 


VARIABLE = "\ 
valuel \ 
value2 \ 
Python RAŠ 


Mia HAL AAP EAS; 不 使 用 tab。 
- Pythons} FH HRA SPB. KERER EH Fotab. 
ShellEaX 
- 每 个 缩 进 使 用 4 个 空格 ; 不 使 用 tab。 
` 2B, flkeOECore, Ashell ži Atab H TR. Aim, see A B Ble 4A 2 6 VA FoPython h MRF Ko 
注释 
` 在 菜谱 、 类 和 配置 文件 中 ， 注 释 是 被 允许 并 且 被 鼓励 的 。 
- 注释 必须 在 一 行 的 开头 使 用 # 字 符 开 始 。 
注释 不 能 被 用 在 延续 中 。 


即使 你 不 打算 向 OpenEmbedded 或 者 Yocto 项 目 提交 补丁 或 者 贡献 菜谱 或 层 ， 遵 循 这 些 简单 的 指导 方针 也 依旧 可 使 为 你 和 你 的 组 织 维 护 你 目 己 的 菜 


谐 、 类 和 配置 文件 变 得 更 加 简单 。 


[1] http: //openembedded.org/wiki/Styleguide. 


8.2 ”与 新 菜谱 





当 工 作 在 OpenEmbedded 构 建 系统 时 ， 为 软件 包 写 新 菜谱 并 且 增 加 它 到 构建 是 必 不 可 少 的 任务 。 一 开始 它 可 能 是 令 人 气 饰 的 ， 但 是 它 不 像 它 看 起 来 
的 那样 困难 。 大 部 分 复杂 性 是 由 各 种 类 来 解决 的 。 图 8-1 显 示 了 一 步 步 写 菜 谱 的 方法 。 


用 于 创建 菜谱 的 工作 流 相 当 类 似 于 我 们 在 第 3 章 中 所 讨论 过 的 、 用 于 构建 包 的 BitBake 过 程 。 当 然 ， 那 不 是 巧合 。 当 创建 新 菜谱 时 ， 你 一 步 一 步 力 每 
个 过 程 步骤 增加 必要 元 数据 。 工 作 沅 也 不 是 像 摘 述 的 那样 线性 ， 而 通 弟 是 做 出 增加 或 者 变更 然后 测试 变更 的 壕 代 。 因 为 前 面 步 骤 的 结果 影响 后 续 步 骤 ， 
所 以 使 得 每 个 步骤 正确 是 重要 的 。 有 有 时， 运行 过 程 步骤 (例如 编译 ) 的 问题 ， 可 能 相关 于 前 面 步骤 中 的 问题 ， 例 如 configure。 


在 写 菜谱 之 前 ,我们 推荐 你 寻找 别人 已 经 写 了 的 并 且 满 足 或 者 至 少 接近 满足 需求 的 菜谱 。OpenEmbedded 元 数据 索引 由 | 是 用 于 搜索 的 好 起 点 。 你 可 
能 找到 你 可 以 为 了 符合 需求 而 修改 的 菜谱 。 然 而 ， 如 果 你 正在 为 你 目 己 的 软件 包 写 菜谱 ， 那 么 这 个 方法 可 能 不 好 使 。 在 这 种 情况 下 ， 你 从 既定 菜谱 开始 
并 且 尝 试 修改 它 可 能 比 从头 或 者 从 菜谱 骨架 创建 菜谱 需要 更 多 的 努力 。 


建立 菜谱 


DRED CHS 


fe AVE AS 


为 源 代 但 打 种 丁 


增加 许可 信和 县 


Autotools 或 者 CMake? 提供 do configure 


配置 源 代码 


Autotoolsak 7 CMake? 提供 do install 









—) 


X 


系统 服务 ? = 起 ”服务 脚本 /文件 已 提供 ? 





提供 脚本 /文件 和 安装 





图 8-1 菜谱 创建 工作 流 


接 下 来 的 部 分 详细 描述 用 于 从 头 创建 菜谱 的 工作 流 步骤 。 


[1] http://layers.openembedded.org. 


8.2.1 PAGE 


即使 你 仅 仪 正在 创建 单一 菜谱 ， 我 们 也 总 是 推荐 你 把 它 放 进 你 自己 的 层 中 或 者 为 它 创 建新 的 层 。 为 什么 ”几乎 没有 项 目 保 持 简 单 。 大 部 分 项 目 随 着 
时 间 而 增长 ， 因 为 你 要 增加 它们 。 通 过 使 用 你 自己 的 层 来 建立 结构 极 大 地 简化 了 将 来 的 维护 。 如 果 你 还 没有 层 来 放 入 菜谱 ， 那 么 你 可 以 简单 地 使 用 
yocto-layer 工 具 来 创建 : 


9 yocto-layer create mylayer 


该 工具 交互 式 地 引导 你 创建 层 并 且 也 为 你 准备 好 创建 样 例 菜谱 。 你 可 以 从 样 例 菜谱 或 者 从 显示 在 程序 清单 8-2 中 的 骨架 开始 。 


程序 清单 8-2 骨架 菜谱 


SUMMARY = "" 

DESCRPTION = "" 
AUTHOR = "" 
HOMEPAGE = " 
BUGTRACKER = "" 


在 层 内 创建 骨架 菜谱 。BitBake 按 照 你 层 内 conf/layer.conf 文 件 中 的 BBFILES 变 量 设置 来 在 层 内 定位 菜谱 。BBFILES 定 义 了 用 于 菜谱 文件 的 搜索 模 


BBFILES += "S{LAYERDIR}/recipes-*/*/*.bb \ 
S{LAYERDIR}/recipes-*/*/* .bbappend" 


当然 ， 你 可 以 为 你 自己 的 层 改 变 搜索 模式 ， 但 是 使 用 以 上 的 默认 是 有 意义 的 ， 因 为 所 有 OpenEmbedded/Yocto 项 目 层 都 使 用 它 。 因 此 ，yocto- 
layer 工 具 创建 具有 这 个 用 于 BBFILES 的 设置 的 conf/layer.conf。 


例如 ， 如 果 你 正在 为 名 为 myapp 的 应 用 创建 菜谱 ， 那 么 你 将 希望 把 菜谱 放 在 目录 recipes-apps/myapp 中 。 


菜谱 名 必须 遵守 在 8.1.1 小 节 讨 论 的 命名 惯例 并 且 应 该 至 少 是 <packagename>_<version>.bb,， 例如 myapp_1.0.bb。 


8.2.2 ”获取 源 代码 
菜谱 做 的 第 一 件 事 是 获取 源 代码 。 因 此 ， 菜 庶 必 须 提供 SRC_URI 以 告诉 构建 系统 从 哪里 获取 源 以 及 使 用 什么 协议 。 获 取 是 通过 do_fetch 任 务 来 执行 
的 。 


对 于 大 部 分 典型 开源 上 游 下 载 来 说 ， 源 文件 是 作为 压缩 包 来 提供 的 。 这 些 包 可 以 通过 使 用 标准 文件 传输 协议 来 获取 ， 正 如 我 们 在 第 3 章 中 详细 讨论 
BitBake 获 取 器 时 看 到 的 。 例 如 ， 


SRC_URI = "http://ftp.gnu.org/gnu/hello/hello-2.9.tar.gz" 


为 GNU Hello World 程 序 获 取 源 包 。 然 而 ， 在 SRC_URI 中 使 用 硬 编码 的 版 本 号 使 得 菜谱 更 不 可 移植 。 作 为 替代 ， 推 荐 使 用 PV: 


SRC_URI = "http://ftp.gnu.org/gnu/hello/hello-S${PV}.tar.gz" 


当 获 取 源 包 时 ， 构 建 系统 要 求 你 提供 MD5 或 SHA256 校 验 和 来 验证 包 是 否 已 经 被 正确 下 载 了 。 你 可 以 直接 指定 校 验 和 为 SRC_URI 的 一 部 分 ,但 是 由 
于 这 些 校 验 和 往往 有 些 不 便 的 ， 所 以 我 们 推荐 你 在 SRC_URI 中 给 包 一 个 名 字 ， 并 且 独 立 指 定 校 验 和 |: 


SRC_URI = "http://ftp.gnu.org/gnu/hello/hello-${PV}.tar.gz;name=archive" 
SRC_URI[archive.md5sum] = "67607d2616a0faaf5bc94c59dca7c3cb" 
SRC_URI[archive.sha256sum] = \ 

"ecbb7a2214196c57££9340aa71458e155 9abd38£6d8d169666846935d£191ea7" 


这 样 做 ,使 得 SRC_URI 更 易于 维护 并 且 当 SRC_URI 包 含 多 个 URI 时 也 工作 得 更 好 。 


和 直接 从 软件 配置 管理 中 获取 源 代码 也 是 常见 的 实践 。 构 建 系统 几乎 支持 所 有 弟 见 软件 配置 管理 系统 。 当 前 最 被 频繁 用 于 开源 软件 的 软件 配置 管理 是 


Git。 从 软件 配置 管理 中 获取 不 要 求 校 验 和 但 是 通常 要 求 要 检 出 的 修订 和 标签 : 


rt 


SRC_URI = "git://git.lttng.org/lttng-ust.git;branch=stable-2.5 \ 
file://lttng-ust-doc-examples-disable.patch \ 


" 


SRCREV = "ce59a99T7afdb/dc8af02b46443 0bb7e35549Ffab66" 


很 多 菜谱 也 要 求 文 件 被 直接 从 构建 主机 本 地 获取 。 通 常 ， 它 们 是 集成 补丁 、 配 置 文件 等 : 


SRC_URI = "git://git.lttng.org/lttng-tools.git;branch=stable-2.5 \ 
file://runtest-2.4.0.patch \ 
file://run-ptest \ 


使 用 file: // 协 议 说 明 符 命令 构建 系统 在 构建 主机 上 寻找 文件 。 路 径 是 相对 于 由 FILESPATH 指 定 的 路 径 的 。 变 量 通常 包含 多 个 路 径 。 首 个 匹配 文件 的 
路 径 被 使 用 。 默 认 情 况 下 ， 在 FILESPATH 中 的 目录 列表 包含 BP ( 基 包 名 和 版 本 ) 、BPN ( 基 包 名 ) 和 files。 所 有 这 些 都 被 假设 成 是 菜谱 所 在 目录 的 子 目 
录 。 


8.2.4 为 源 代码 打 补 丁 


如 果 SRC_URI 包 含 任何 补丁 ， 也 融 是 以 .patch 或 者 .diff 结 尾 的 文件 ， 那 么 qdo_patch 任 务 使 用 Quilft 工 具 目 动 应 用 这 些 补丁 到 已 解压 的 源 代 码 。 


构建 系统 期 望 补 本 可 以 用 -p1 选 项 来 应 用 ， 这 意味 着 第 一 级 目录 是 被 除去 的 。 如 果 补 丁 需要 多 级 目录 被 除去 ， 那 么 你 需要 提供 striplevel 选 项 和 数字 
作为 补丁 SRC_URI 的 一 部 分 。 如 果 补 丁 需要 被 应 用 进 特定 的 、 不 是 在 补丁 文件 本 身 内 提供 的 子 目录 中 ， 那 么 你 增加 patchdir 选 项 到 SRC_URI : 


SRC_URI = "http://downloads.tld.com/pub/package-1.2.tar.gz \ 
file://patch-1.patch;striplevel=3 \ 
file://patch-2.diff;patchdir=src/common \ 


你 应 该 把 补丁 和 任何 其 他 本 地 获取 的 文件 放 在 菜谱 旁边 的 子 目 录 中 ， 子 目录 被 命名 成 和 菜谱 的 基 名 称 BPN 相 同 ， 或 者 被 命名 成 基 名 称 加 版 本 号 BP， 
或 者 被 命名 成 files。 例 如 ， 如 果菜 谱 的 名 字 是 foo_2.3.1.bb， 那 么 目录 的 名 字 可 以 是 foo、foo-2.3.1 和 files 其 中 之 一 。 使 用 foo 而 不 是 files 有 助 于 为 不 同 
菜谱 组 织 补丁 。 使 用 foo-2.3.1 而 不 是 foo 人 允许 为 不 同 版 本 的 foo 荣 谱 分 开 补 丁 。 


8.2.5 ”增加 许可 信息 
所 有 菜谱 都 不 要 求 通过 设置 变量 LICENSE 和 LIC_FILES CHKSUM 来 提供 许可 信息 。 这 两 个 变量 都 是 强制 的 ， 否 则 ， 构 建 系统 拒绝 菜谱 并 且 不 构建 
È. 


- LICENSE: 用 于 这 个 软件 包 的 许可 名 字 。 在 大 部 分 情况 下 ， 仅 有 单一 许可 适用 ， 但 是 一 些 开 源 软件 包 使 用 多 个 许可 。 这 些 可 以 是 允许 包 用 户 从 数 
个 许可 中 选择 其 一 的 双 许 可 或 者 是 在 其 中 软件 包 的 部 分 授权 不 同 的 多 许可 。 双 许可 是 通过 以 管道 符号 (|) 连接 许可 名 字 来 指定 的 。 多 许可 是 通过 以 & 连 
接 许 可 名 字 来 指定 的 。 构 建 系 统 也 支持 复杂 的 逻辑 许可 算术 ， 例 如 GLv2& (LGPLv2.1|MPL-1.1|BSD) 。 


“ 上 LIC_FILES_ CHKSUM: 这 个 变量 允许 追踪 对 许可 文件 本 身 的 变更 。 变 量 包含 许可 文件 以 及 它们 各 自 校 验 和 的 空格 分 隔 列 表 。 在 获取 并 解压 了 软件 
包 的 源 文 件 后 ， 构 建 系统 通 过 对 许可 文件 或 者 许可 文件 的 部 分 计算 校 验 和 ， 以 及 将 其 与 所 提供 校 验 和 进行 比较 来 验证 许可 。 


由 LIC FILES CHKSUM 列 出 的 许可 可 以 有 任何 名 字 ， 只 要 名 字 不 含有 任何 空格 或 者 字符 &、|、“(” 和 “)”。 对 于 标准 许可 ， 我 们 推荐 你 使 用 
meta/files/common-licenses 中 的 许可 文件 名 或 者 来 自 meta/conf/licenses.conf 中 的 SPDXLICENSEMAP 属 性 的 许可 名。 


如 果 源 包 在 文件 (例如 COPYING、LICENSE 或 者 类 似 文件 ) 中 提供 实际 的 许可 ， 那 么 你 应 该 在 LIC_FILES_ CHKSUM 中 指定 它 : 
LIC FILES CHKSUM = "f 1le://COPYING; md5=<md5sum>" 


一 些 使 用 标准 开源 许可 的 软件 包 可 能 简单 地 陈述 名 字 和 许可 的 版 本 但 不 包含 许可 文件 本 身 。 在 这 种 情况 下 ， 使 用 在 COMMON_LICENSE_DIR 中 提供 
的 许可 文件 : 


LIC_FILES_CHKSUM = \ 
"file://${COMMON_LICENSE_DIR}/MIT;md5=083 5ade698e0bcf£8506ecda2£7b4£302" 


如 果 你 没有 许可 文件 的 MD5 校 验 和 ， 那 么 你 不 需要 手动 计算 它 。 仅 仅 把 md5 参 数 留 空 ， 构 建 系统 以 提供 校 验 和 的 错误 消息 退出 ， 然 后 你 可 以 复制 和 


粘贴 这 个 校 验 和 进 菜谱 中 。 


8.2.6 ”配置 源 代 码 
构建 软件 包 通 常 依赖 于 构建 系统 和 构建 环境 ， 例 如 开发 工具 以 及 对 其 他 软件 包 和 库 的 依赖 性 。 这 尤其 友 生 在 为 不 同 染 构 交 又 构建 时 。 为 了 保证 源 包 
是 可 移植 的 以 便 它们 可 以 在 各 种 具有 不 同 构建 环境 的 构建 系统 上 为 大 量 目标 系统 构建 ， 开 发 者 提供 用 于 配置 源 代码 和 它 的 构建 系统 的 方法 。 


在 最 简单 的 情况 下 ， 这 个 配置 是 通过 设置 环境 变量 来 实施 的 ， 源 代码 构建 系统 将 该 变量 用 于 它 的 makefiles 和 构建 脚本 。 不 笠 的 是 ， 这 个 方法 是 非 党 
不 用 户 友好 的 ， 因 为 ， 为 了 能 够 提供 正确 的 设置 ， 希 望 构建 软件 包 的 人 需要 理解 变量 和 他 们 打算 做 的 事 。 不 同 开 肥 者 也 倾向 于 以 不 同方 式 命 名 变量 ， 这 
增加 了 复杂 度 。 虽 然 有 一 些 达 成 一 致 的 公分 母 一 一 例如 ， 作 为 用 于 C 编 译 器 变量 的 CC、 用 于 C++ 编 译 器 的 CPP 和 用 于 链接 器 的 LD 一 一 但 是 开 友 者 仍然 可 


能 定义 你 可 能 需要 解决 的 其 他 变量 。 


为 了 缓和 问题 ， 构 建 系统 被 开 友 成 使 源 代 码 以 标准 化 的 方式 可 移植 。 两 个 钊 见 的 构建 系统 是 GNU Autotools 和 CMake。 这 两 者 都 旨 在 通过 为 源 代 码 
配置 提供 目 动 化 工具 来 简化 源 代码 的 移植 并 使 配置 用 户 友好 。 这 些 工具 通过 将 随 源 代 码 一 起 交付 的 配置 文件 和 实际 构建 系统 进行 匹配 并 构建 环境 配置 来 
决定 必要 的 配置 ， 然 后 基于 输出 设置 需要 的 变量 。 


作为 第 一 个 步骤 ， 你 需要 决定 你 正在 为 其 编写 菜谱 的 包 依 赖 于 哪些 其 他 软件 包 。 通 常 ， 软 件 包 的 文档 应 该 提供 给 你 这 个 信息 。 你 需要 增加 这 些 包 到 
DEPENDS 变 量 以 便 BitBake 可 以 首先 构建 这 些 包 来 满足 依赖 性 。 


第 二 ， 你 需要 决定 你 正在 构建 的 软件 包 是 否 使 用 源 配置 系统 。 


- GNU Autotools: 如 果 软 件 包 包含 configure.ac 文 件 ， 那 么 它 使 用 GNU Autotools。configutre.ac 文 件 包 含 用 于 检测 编译 器 、 了 寻找 特 定 头 文件 、 测 试 库 
等 的 宏 (macros) 列表 。autoconf 工 具 从 这 个 名 为 configure 的 文件 创建 一 个 shell 脚 本 然后 执行 实际 的 测试 。GNU Autotools 构 建 在 传统 的 Make 原 生 系 统 之 
上 ， 并 用 于 构建 软件 包 。 在 configure 脚 本 已 经 成 功 完 成 后 ， 它 创建 makefile。 


如 果 软 件 包 使 用 GNU Autotools， 那 么 所 有 你 要 做 的 事情 是 继承 autotools 类 。 这 个 类 提供 do_configure 任 务 ， 并 且 在 大 部 分 情况 下 ， 你 不 需要 进 
一 步 修改 配置 。 


然而 ， 一 些 软件 包 可 能 依然 要 求 你 对 配置 做 调整 。 为 了 这 个 目的 ，OpenEmbedded 构 建 系统 提供 允许 你 增加 或 者 覆盖 配置 设置 的 变量 
EXTRA_OECONF。 


- CMake: 如 果 软 件 包 包含 CMakeLists.txt 文 件 ， 那 么 它 使 用 CMake。 这 个 文件 包含 配置 指令 。CMake 和 例如 Make 的 原生 构建 系统 结合 使 用 。 


如 果 软 件 包 使 用 CMake， 那 么 所 有 你 必须 做 的 事情 是 继承 cmake 类 。 这 个 类 提供 do_configure 任 务 ， 并 且 在 大 部 分 情况 下 ， 你 不 需要 进一步 修改 配 
置 。 


如 果 你 需要 对 配置 做 调整 ， 那 么 OpenEmbedded 提 供用 于 传递 任何 需要 的 配置 选项 的 EXTRA_OECMAKE 变 量 。 


- Other: 如 果 源 包 不 包含 configute.ac 或 者 CMakeLists.txt 文 件 ， 那 么 它 正 在 通过 直接 传递 环境 变量 到 构建 系统 来 使 用 某 个 其 他 的 配置 方法 。 如 果 是 这 
种 情况 ， 你 可 能 必须 编写 你 自己 的 do_configute 任 务 来 应 用 正确 的 设置 。 在 简化 的 情况 下 ， 设 置 EXTRA_OEMAKE 变 量 以 传递 设置 是 足够 的 。 


此 时 ， 你 应 该 运行 configure 任 务 并 且 检 查 它 的 日 志文 件 以 保证 配置 成 功 了 并 且 正 确 的 选项 已 经 被 传递 了 。 日 志 也 告诉 你 是 否 你 缺失 DEPENDS 变 量 
中 所 需要 的 任何 依赖 项 或 者 是 否 你 可 能 不 希望 启用 的 选项 已 经 被 启用 了 。 


8.2.7 ”编译 


现在 菜谱 已 经 残 绪 于 编译 源 代 码 。 运 行 compile 任 务 并 且 看 看 编译 是 否 成 功 了 。 如 果 成 功 了 ， 那 么 对 这 一 步 来 说 ， 你 没有 任何 其 他 要 做 的 了 。 然 而 ， 
如 果 编 译 失败 ， 那 么 你 需要 分 析 日 志文 件 以 得 到 根源 。 此 时 ， 最 弟 见 的 失败 是 并 行 构建 失败 (parallel build failure) 、 主 机 泄露 (host leakage) 、 缺 
失 头 文件 或 者 库 : 


- 并 行 构 建 失败 : 为 Make 使 用 多 线程 默认 是 由 你 构建 环境 的 conf/local.conf 中 的 PARALLEL_MAKE 为 所 有 包 都 启用 的 。 有时， 这 可 能 导致 竞 态 条 件 


(race condition) ， 它 表现 为 间 歌 性 失败 (intermittent failure) 。 通 常 ， 编 译 失 败 是 因为 应 该 已 经 被 创建 的 制品 不 能 被 找到 。 这 些 失 败 难 以 追踪 ， 为 在 
检查 时 ， 你 可 能 发 现 制品 确实 已 经 被 创建 了 ; 然而 ， 问 题 是 ， 构 建 过 程 的 部 分 已 经 以 错误 的 顺序 执行 了 。 


作为 变通 方法 ， 你 可 以 在 菜谱 中 设置 PRALLEL_MAKE="”( 空 字符 串 ) 。 这 个 设置 仅仅 为 这 个 菜谱 天 闭 并 行 构 建 。 当 然 ， 它 减 慢 构建 软件 包 。 如 果 
你 希望 解决 问题 并 且 人 允许 并 行 构 建 ， 那 么 你 可 能 需要 做 进一步 的 调试 并 且 最 终 应 用 补丁 以 改变 构建 过 程 的 顺序 。 


. 主机 泄露 : 这 个 问题 与 为 目标 构建 有 关 ， 或 者 是 在 构建 软件 开发 工具 包 时 发 生 。 当 构建 过 程 从 主机 系统 而 不 是 从 交叉 构建 环境 引用 头 文件 、 库 或 
者 其 他 文件 时 ， 问 题 发 生 。 几 乎 在 所 有 案例 中 的 根本 原因 是 ,例如 /ust/include、/ust/lib 等 绝对 路 径 的 使 用 。 主 机 泄露 是 由 质量 保证 工具 报告 的 ， 包 括 
Swabber。 你 应 该 能 够 从 质量 保证 消息 中 通过 分 析 日 志文 件 来 简单 地 认 出 这 些 问题 ， 然 后 创建 补丁 来 解决 它们 。 


缺失 头 文件 或 者 库 : 如 果 因 为 编译 器 找 不 到 来 自 其 他 软件 包 的 头 文件 或 者 库 而 编译 失败 ， 那 么 根本 原因 通常 是 这 些 包 还 没有 被 声明 在 DEPENDS 交 
量 中 ， 或 者 依赖 性 存在 但 是 到 文件 的 路 径 是 不 正确 的 ， 并 且 它 没有 被 配置 步骤 正确 地 检测 到 。 


在 大 部 分 情况 下 ， 增 加 依赖 性 到 DEPENDS 可 以 解决 问题 。 然 而 ， 它 可 能 不 立即 表现 它 上 自己 。 通 剃 ， 你 以 已 经 用 于 构建 目标 根 文件 系统 的 构建 环境 来 
开始 。 在 很 多 情况 下 ， 在 你 开始 为 新 包 增 加 菜谱 前 ， 依 赖 性 可 能 已 经 为 其 他 软件 包 所 构建 了 ， 这 导致 依赖 性 得 以 实现 ， 尽 管 没有 在 DEPENDS 中 声明 。 对 
这 种 情况 ， 建 议 用 全 新 的 构建 环境 来 测试 。 


很 少 的 情况 下 ， 你 可 能 需要 通过 设置 变量 STAGING BINDIR, STAGING INCDIR, STAGING DATADIR 和 STAGING BASELIBDIR 等 来 调整 到 依赖 
性 的 头 文件 和 库 的 路 径 。 


8.2.8 ”安家 构建 输出 


在 软件 包 祝 构建 后 ，do_install 任 务 复制 例如 二 进 制 、 库 、 头 文件 、 配 置 文件 和 文档 文件 的 构建 制品 到 镜像 了 目标 设备 的 根 文 件 系统 的 文件 系统 层级 
结构 中 。 文 件 从 S、B 和 WORKDIR 目 录 中 复制 到 D 目 录 ， 其 通常 被 设置 成 $fIWORKDIR}Yimage。 在 安 六 后 ， 这 个 目录 包含 具有 已 安 闪 软件 包 的 所 有 子 目 
录 和 文件 的 本 地 根 文件 系统 。 


因为 打包 过 程 从 安 半 目录 D 中 收集 文件 ， 所 以 你 必须 保证 软件 包 已 经 被 正确 地 安装 了 : 所 有 你 已 经 创建 的 子 目录 和 文件 位 于 根 文 件 系统 结构 的 正确 位 
置 。 依 赖 于 软件 包 是 如 何 被 构建 的 ， 你 可 能 需要 对 安 六 过 程 做 出 调整 : 


- GNU Autotools#qCMake: 如 果 软 件 是 使 用 GNU Autotools 或 者 CMake 来 构建 的 ， 那 么 autotools 和 cmake 类 各 自 提供 足以 安装 大 部 分 软件 包 的 
do_install 任 务 。 你 仅仅 需要 验证 ，do_install 任 务 毫 无 问题 地 完成 了 ， 并 且 在 D 中 的 目录 结构 是 正确 的 。 


如 果 你 需要 安装 还 没有 被 由 类 提供 的 do_install 任 务 复 制 的 额外 文件 ， 那 么 你 需要 在 菜谱 中 创建 处 理 安装 剩余 文件 的 do_install append. 1R% 
须 使 用 install-d<source> <dest> 来 复制 文件 而 不 是 使 用 cp 或 者 任何 其 他 实用 程序 。 


. Make: 如果 软 件 包 是 仅仅 使 用 不 带 GNU Autotools 或 者 CMake 的 Make 构 建 系统 来 构建 的 ， 那 么 你 需要 在 菜谱 中 创建 do_install 任 务 。makefile 很 可 能 
已 经 包含 了 安装 目标 来 复制 文件 。 这 个 目标 通常 需要 目的 目录 ， 它 是 文件 系统 结构 的 根 目 录 并 且 可 以 通过 变量 来 设置 。 这 个 变量 是 什么 依赖 于 makefile。 
典型 的 例子 是 DESTDIR、PREFIX 和 INSTALLROOT。 


OpenEmbedded 构 建 系统 提供 函数 oe runmake， 它 用 特定 的 目标 执行 Make。 这 个 函数 允许 你 传递 变量 到 makefile。 你 简单 地 在 do_install 任 务 
中 使 用 那个 函数 ， 如 下 ， 假 设 被 makefile 需 要 的 用 于 传 到 根 安装 目录 的 变量 名 为 PREFIX: 


do_install() { 
oe runmake install PREFIX=${D} 


如 果 makefile 不 提供 安 丢 目标， 那么 请 看 下 一 个 用 于 手动 安 准 的 痢 重 号 。 


Fe: 软件 包 构 建 系统 根本 不 提供 安装 功能 ， 你 需要 创建 do_install 任 务 并 且 使 用 install-d<src><dest> 来 安装 需要 的 文件 : 


do install() { 
install -d ${B}/bin/hello S${D}S{bindir} 
install -d S${B}/lib/hello.lib ${D}${libdir} 


你 可 以 使 用 下 列 用 于 标准 安装 路 径 的 变量 并 且 把 它们 和 D 连 接 起 来 : 
E bingir = "serpin" 
€ soindir = "/usr/sbin" 


=m libdir = "/usr/lib" 


= libexecdir = "/usr/lib" 

= sysconfdir = "/etc" 

= datadir = "/usr/share" 

= mandir = "/usr/share/man" 

=" includedir = "/usr/include" 


JI T Sree, IBTECRESH BW DE RAT BRAN. 


8.2.9 ”设置 系统 服务 


如 果 软 件 包 提供 需要 在 系统 启动 时 被 启动、 在 系统 关闭 时 被 停止 的 系统 服务 ， 那 么 菜谱 需要 为 软件 包 设 置 系 统 服 务 。 


首先 ， 你 需要 验证 软件 包 是 否 提 供 必 要 启动 脚本 ， 并 且 安 装 任 务 把 它们 复制 进 正确 的 位 置 。 这 些 脚本 需要 包含 什么 以 及 它们 被 安 六 在 什么 地 方 依 赖 
于 你 正在 使 用 的 服务 管理 器 。 如 果 包 不 提供 脚本 或 者 不 安 准 它们 ， 那 么 你 必须 增加 它们 并 且 追 加 do _install 任 务 。 


构建 系统 支持 这 两 种 服务 管理 器 SysVinit 和 systemd : 


- SysVinit: System V Init 是 用 于 类 UNIX 系 统 的 传统 服务 管理 器 。 当 Linux 内 核 在 启动 时 完成 了 它 的 初始 化 以 后 ， 它 派生 init 进 程 ， 然 后 它 执 行 服务 脚 


本 并 且 按 照 运 行 级 别 和 优先 级 启动 服务 。 


do _install 任 务必 须 把 服务 start-stop-script 安 装 进 恰当 的 目录 中 ， 通 常 是 /etc/init.d。 然 后 服务 需要 通过 创建 从 资源 控制 目录 (/etc/rc0.d 
到 /etc/rc6.d) 到 脚本 的 链接 来 启用 ， 结 果 就 是 ， 当 系统 进入 特定 运行 级 别 时 ， 服 务 可 以 被 启动 和 停止 。 这 是 通过 update-rc.d 类 来 完成 的 ，update-rc.d 
类 使 用 菜谱 需要 继承 的 update-rc.d 工 具 。 类 做 所 有 配置 工作 。 所 有 需要 的 事物 是 在 菜谱 中 用 于 向 类 提供 必要 配置 的 3 个 变量 : 


INITSCRIPT_PACKAGES: 包含 用 于 这 个 软件 包 init 脚 本 的 包 列 表 。 这 个 变量 是 可 选 的 ， 并 且 默 认 成 INITSCRIPT_PACKAGES="${PN}"。 
- INITSCRIPT_NAME: init 脚 本 的 名 字 。 


- INITSCRIPT PARAMS: 传递 到 update-rc.d 的 参数 。 这 可 以 是 例如 "defaults 8020" 的 字符 串 ， 用 来 在 进入 运行 级 别 2、3、4、5 时 启动 服务 和 在 进入 运 
行 级 别 0、1、6 时 停止 它 。update-tc.d 手 册 中 提供 了 关于 工具 和 它 的 使 用 的 细节 。 
-systemd: 系统 管理 守护 进程 (System Management Daemon, systemd) 是 作为 日 渐变 老 的 SysVinit 的 替代 物 而 开发 的 。 特 别 是 ， 它 提供 了 服务 间 更 


好 的 优先 级 化 和 依赖 处 理 以 及 并 行 启动 服务 的 能 力 ， 它 加 速 了 系统 的 启动 序列 。systemd 主 页 门 提供 了 详细 的 信息 。 软 件 包 必须 提供 给 systemd 服 务 脚本 ， 


并 且 菜 谱 必 须 在 恰当 的 位 置 安 装 它 ， 位 置 通常 是 /lib/systemd/system。 然 后 菜谱 通过 继承 systemd 类 和 提供 下 面 的 变量 来 配置 服务 : 


- SYSTEMD_PACKAGES: 包含 用 于 软件 包 的 Systemd 服 务 文件 的 包 列表 。 这 个 变量 是 可 选 的 ， 并 且 默 认 成 SYSTEMD_PACKAGES='"${PN}"。 

- SYSTEMD SERVICE: 服务 文件 的 名 字 。 

里 然 Linux 系 统 明 显 只 能 利用 仪 仪 系 统管 理 服务 ， 但 是 你 可 以 编写 菜谱 来 支持 这 两 者 。 类 和 变量 不 ;中 突 ， 并 且 构 建 系统 从 菜谱 中 选择 正确 的 设置 。 
为 得 到 更 多 天 于 如 何 设置 系统 服务 的 信息 ， 参 见 update-rc.d.bbclass 和 systemd.bbclass， 并 且 碍 阅 各 自 系 统 服务 管理 器 的 文档 。 


[1] www.tin.org/bin/man.cgiPsection=8&topic=update-tc.d.o 


[2] www. freedesktop.org/wiki/Software/systemd. 


8.2.10 ”打包 构建 输出 


此 时 ， 软 件 包 的 所 有 必要 文件 都 被 构建 并 且 被 组 织 在 目的 目录 D 内 的 文件 系统 结构 中 。 下 一 步 是 由 do_package 任 务 执行 的 ， 是 收集 文件 并 且 为 包 管 
理 系统 分 配 它 们 进 包 中 。 


包 拆 分 


把 构建 输出 (build output) 分 组 到 不 同 包 的 过 程 被 称 为 包 拆 分 (package splitting) 。 大 部 分 软件 产生 很 多 不 同 制品 ， 依 赖 于 需求 ， 你 可 能 只 需 
要 其 中 一 些 被 安 妆 进 目 标 设备 的 根 文 件 系统 中 。 拆 分 包 以 只 选择 你 需要 的 制品 帮助 你 控制 你 系统 的 内 人 存 占用 并 且 吉 免 其 安 疼 可 能 对 设备 造成 安全 风险 的 
二 进 制 、 库 、 调 试 信息 以 及 其 他 文件 。 


两 个 控制 包 拆 分 的 变量 是 PACKAGES 和 FILES : 


- PACKAGES: 这 个 变量 是 空格 分 隔 的 包 名 字 的 列表 。 被 定义 在 meta/conf/bitbake.conf 中 的 这 个 变量 的 默认 值 是 PACKAGES='"${IPN}-dbg$fPN}- 
staticdev$ {PN}-dev$ {PN}-doc${PN}-locale$ {PACKAGE_BEFORE_PN}${PN}"。do_package 任 务 从 左 到 右 处 理 列表 ， 首 先 创建 最 左 侧 的 包 ， 最 后 创建 最 右 
侧 的 包 。 顺 序 是 重要 的 ， 为 包 消 耗 与 它 相 关联 的 文件 。 





. FILES: FILES 变 量 定义 被 放 进 特定 包 中 的 目录 和 文件 的 列表 。 这 个 变量 总 是 和 条 件 赋值 一 起 使 用 ， 例 如 : 
FILES S{PN}-dbg = "<files>" 


其 中 files 是 空格 分 隔 的 、 可 以 包含 通配符 以 匹配 用 于 do_install 任 务 在 其 中 创建 目录 和 安 凌 文件 的 目的 目录 D 的 目录 结构 部 分 的 目录 和 文件 列表 。 用 
于 针对 列 在 PACKAGES 中 的 默认 包 的 FILES 默 认 设置 被 定义 在 meta/conf/bitbake.conf。 


用 于 PACKAGES 和 FILES 的 默认 设置 满足 大 部 分 软件 包 的 需求 。 然 而 ， 软 件 包 可 能 创建 额外 的 制品 并 且 安 六 它们 到 没有 被 默认 设置 所 包含 的 目录 中 。 
在 其 他 情况 下 ， 虽 然 被 默认 设置 所 满足 ， 但 是 你 可 能 希望 进一步 拆 分 包 ， 例 如 为 多 个 被 创建 的 二 进 制 创建 不 同 的 包 。 在 以 上 两 种 情况 下 ， 你 需要 增加 包 
名 到 PACKAGES 或 通过 增加 到 FILES 来 包含 额外 的 制品 。 程 序 清单 8-3 演 示 了 如 何 定制 打包 。 


程序 清单 8-3 ”定制 打包 


SUMMARY = "Hello Universe Application" 

DESCRPTION = "The ultimate hello extending beyond 'world'." 
AUTHOR = "sSpacey@universetrotter.com" 

HOMEPAGE = "“http://universetrotter.com" 

BUGTRACKER = "https://bugs.universetrotter.com" 


PN = "hellouniverse'" 


# Other recipe stuff 
# ... 


PACKAGES =+ "graphics" 
FILES_${PN}-graphics = "${datadir}/pixmaps/*" 
FILES _${PN}-doc =+ "${datadir}/blurbs/*" 


PACKAGE BEFORE _PN = "examples" 
FILES ${PN}-examples = "${datadir}/examples" 


在 程序 清单 8-3 中 的 例子 前 新 增 名 为 graphics 的 额外 包 到 PACKAGESs 并 且 设 置 FILES_${PN}-graphics 到 过 滤器 。 它 也 奶 加 过 滤器 到 FILES_4${PN}-doc 
来 从 非 标准 的 9{datadirMblurb 目 录 收 集 文 档 文件 并 且 把 它们 放 进 doc 包 中 。 


在 PACKAGES 的 默认 列表 中 的 最 后 包 是 ${PN}， 它 是 标准 包 。 对 FILES 相 关 的 定义 最 终 消 耗 所 有 尚未 被 其 之 前 包 所 声明 的 文件 和 目录 : 


SOLIBS = = 80, ™" 

FILES S{PN} = "S{bindir}/* Ş{sbindir}/* ${libexecdir}/* ${libdir}/lib* \ 
{SOLIBS} S{sysconfdir} S${sharedstatedir} S${localstatedir} \ 
S{base_bindir}/* S${base_sbindir}/* \ 
S{base_libdir}/*S{SOLIBS} \ 

S{base_prefix}/lib/udev/rules.d Sprefix}/lib/udev/rules.d \ 
S{datadir}/${BPN} ${libdir}/${BPN}/* \ 

S{datadir}/pixmaps S${datadir}/applications \ 

S{datadir}/idl S${datadir}/omf ${datadir}/sounds \ 
S{libdir}/bonobo/servers" 


BitBake 语 法 仅仅 允许 你 追加 或 者 前 新 增 到 变量 。 然 而 ， 如 果 你 需要 在 ${PN} 包 之 前 嵌入 包 ， 那 么 你 可 以 设置 PACKAGE_BEFORE_PN 变 量 并 且 使 用 
对 FILES 的 条 件 赋值 来 设置 文件 过 滤器 ， 正 如 在 程序 清单 8-3 中 所 示 的 那样 。 


最 后 两 个 控制 打包 的 变量 是 PACKAGE DEBUG SPLIT STYLE 和 PACKAGESPL-ITFUNCS。 前 者 给 了 你 对 如 何 处 理 二 进 制 和 调试 对 象 的 控制 。 后 者 让 
你 为 包 拆 分 增加 你 自己 的 函数 到 菜谱。 它们 是 不 党 用 的 。 我 们 在 8.1.2 小 节 解 释 了 基础 。 


打包 质量 保证 


insane 类 增加 合理 性 和 错误 检查 到 打包 过 程 。 类 定义 检查 冰 数 的 列表 ， 检 查 函 数 在 打包 过 程 之 前 、 期 间 和 之 后 被 调 用 ， 例 如 属 主 和 文件 /目录 权限 、 
用 于 可 执行 文件 和 库 的 正确 架构 、 调 试 包 对 非 调 试 包 的 依赖 性 等 。 为 得 到 函数 列表 ， 请 参考 类 本 身 或 者 Yocto 项 目 参考 手册 |. 


你 可 以 使 用 变量 WARN_QA 和 ERROR_QA 来 决定 质量 保证 函数 是 否 应 该 创建 警告 消息 ， 其 让 构建 继续 ， 并 且 成 功 而 不 管 警告 ; 或 者 创建 错误 消息 ， 
其 让 构建 失败 。 你 通 单 在 全 局 的 级 别 设 置 这 些 变量 ， 要 么 正如 在 前 面 章节 中 概述 的 ， 在 上 友 行 版 配置 文件 中 设置 ， 要 么 在 构建 环境 的 confWlocal.conf 中 。 


如 果 你 需要 为 菜谱 禁用 特定 的 检查 ， 你 可 以 使 用 INSANE SKIP 变量 。 例 如 ， 


INSANE SKIP S{PN} += "dev-so" 


为 动态 加 载 的 库 跳 过 符号 链接 检查 。 通 常 ， 这 些 链 接 仅仅 对 于 开发 包 有 用 ， 但 是 一 些 软 件 包 可 能 需要 它们 以 正常 工作 ，。 


除了 由 insane 类 执行 的 自动 化 的 检查 以 外 ， 你 可 以 手动 验证 正确 的 包 拆 分 。 目 录 $fWORKDIR}/packages-split 包 含 用 于 被 创建 的 每 个 包 的 独立 目录 


一 般 来 说 ， 构 建 系统 把 所 有 包 标 记 成 是 特定 于 目标 染 构 的 。 那 个 惯例 对 于 大 部 分 包 是 恰当 的 。 有 两 个 你 可 能 需要 调整 包 架构 的 用 例 : 


. 机 器 依赖 包 : 如 果 包 依赖 于 它 为 其 构建 的 特定 机 器 ， 这 通常 发 生 在 当 它 执行 do_configute 任 务 传递 MACHINE 变量 设置 到 配置 脚本 的 情况 下 ， 那 么 
你 需要 显 式 地 设置 包 架 构 为 : 


PACKAE ARCH = "S${MACHINE_ARCH) 


. 架构 独立 包 : 如 果 包 适用 于 所 有 架构 而 不 管 它 为 其 构建 的 机 器 是 什么 ， 例 如 ， 如 果 它 是 字体 或 者 脚本 包 ， 那 么 菜谱 需要 继承 allatch 类 来 正确 地 标记 


Gy 


inherit allarch 


即使 你 不 显 式 地 改变 包 架 构 ， 我 们 仍然 推荐 你 尝试 通过 设置 你 构建 环境 的 conf/local.conf 文 件 中 的 MACHINE 变 量 来 为 不 同 机 器 做 多 个 构建 的 方法 
来 为 不 同 架 构 构建 包 。 


[1] www. yoctoproject.org/docs/1.6.1/ref-manual/ref-manual.html#ref-classes-insane o 


8.2.11 ”定制 安 委 脚本 


包 管 理 器 有 能 力 在 包 被 安 疼 、 升 级 或 者 印 载 之 前 和 之 后 运行 定制 脚本 。 这 些 脚本 是 包含 在 包 中 的 ， 并 且 当 脚本 被 调用 以 执行 特定 动作 时 ， 包 管理 系 
统 执行 它们 。OpenEmbedded 构 建 系统 支持 提供 这 样 的 脚本 作为 菜谱 的 一 部 分 。 它 们 被 作为 消 数 而 加 到 菜谱 中 。package 类 拿 出 函数 并 且 按 照 包 管 理 系 
统 增加 它们 到 各 自 的 包 。 机 制 对 包 管 理 系统 是 透明 的 ， 并 且 仅 仅 为 RPM、dpkg 和 ipkg 所 支持 。tar 打 包 不 支持 定制 安装 脚本 。 你 可 以 定义 以 下 4 个 脚本 : 


- pkg preinst <packagename>: 在 包 被 安装 前 运行 的 安装 前 脚本 (preinstallation script) o 
- pkg postinst <packagename>: 在 包 被 安装 后 运行 的 安装 后 脚本 (postinstallation script) o 
- pkg_prerm_<packagename>: 在 包 被 印 载 前 运行 的 卸载 前 脚本 (pre-uninstallation script) o 
pkg_postrm_<packagename>: 在 包 被 卸载 后 运行 的 卸载 后 脚本 (post-uninstallation script) 。 
你 需要 用 包 的 名 字 蔡 换 <packagename>， 它 是 列 在 PACKAGES 变 量 中 的 名 字 之 一 。 指 定 包 名 人 允许 你 条 件 性 地 应 用 脚本 到 特定 包 。 
定制 脚本 通常 是 shell 脚 本 。 程 序 清 单 8-4 显 示 了 用 于 主要 包 4{PN]) 的 安装 后 脚本 的 骨架 。 
程序 清单 8-4 ”安装 后 脚本 骨架 
pkg_postinst_S{PN}() { 
#!/bin/sh 


# shell commands go here 


} 


这 个 脚本 是 在 包 被 安 妆 后 执行 的 。 为 了 包 成 功 安 妆 ， 脚 本 必须 成 功 完 成 。 不 管 包 管理 器 是 由 OpenEmbedded 构 建 系 统 在 创建 根 文件 系统 时 运行 的 ， 
还 是 被 运行 在 目标 上 ， 脚 本 都 执行 。 在 一 些 情况 下 ， 你 可 能 希望 仅仅 通过 在 目标 上 执行 包 管 理 器 将 包 安 六 在 目标 上 时 才 运 行 脚本 ， 或 者 你 可 能 希望 当 安 
六 在 目标 上 时 执行 不 同 的 命令 。 程 序 清单 8-5 显 示 了 如 何 实现 那个 目的 的 骨架 ，。 


程序 清单 8-5 ”条件 安装 后 脚本 骨架 


pkg_postinst_S{PN}() { 


#!/bin/sh 
af | ="SD" = "x" |* then 
# shell commands for target execution 
else 
# shell commands for build system execution 
fi 
} 


在 程序 清单 8-5 中 的 骨架 脚本 背后 的 逻辑 是 ， 目 的 目录 变量 D 是 在 构建 系统 的 上 下 文中 而 不 是 当 包 管 理 器 人 在 目标 上 被 执行 时 来 设置 的 。 


8.2.12 ZAA 


所 有 菜谱 为 目标 构建 软件 包 。 如 果 你 希望 菜谱 为 构建 主机 或 除了 目标 之 外 的 软件 开发 工具 包 而 构建 ， 那 么 你 必须 设置 BBCLASSEXTEND 变 量 : 
. native: 为 构建 主机 构建 。 
-Native-sdk: 为 软件 开发 工具 包 构 建 。 


当 构 建 变 体 时 ， 你 可 能 需要 按 需 通过 条 件 设置 或 者 覆盖 变量 来 对 菜谱 做 调整 。 


8.3 EMF 


这 部 分 提供 如 何 为 构建 不 同类 型 的 软件 包 编写 菜谱 的 例子 。 这 些 是 具有 目的 性 的 人 入 单 例子 ， 你 可 以 立即 使 用 你 自己 的 构建 环境 来 测试 它们 。 一 如 噬 
往 ， 我 们 推荐 你 为 它 创 建 你 自己 的 层 : 


9 yocto-layer create mylayer 


让 工具 为 你 创建 样 例 菜谱 ， 或 者 手动 创建 目录 结构 和 文件 。 例 子 是 应 用 ， 我 们 假设 它们 被 放 在 meta-mylayer/recipes-apps/<appname> 下 面 的 层 


不 要 扎 记 通过 增加 层 到 你 构建 环境 的 conf/bblayers.conf 中 的 BBLAYERS 变 量 来 在 构建 环境 中 包 合 它 。 


8.3.1 Cx 文件 软件 包 

这 个 例子 演示 了 如 何 编写 直接 从 软件 包 的 源 文件 构建 软件 包 的 菜谱 。 昌 然 这 个 技术 不 常 被 使 用 ， 因 为 几乎 所 有 包 都 使 用 某 种 构建 系统 ， 例 子 显示 了 
构建 系统 可 以 被 调整 成 构建 任何 包 。 而 且 ， 如 果 你 有 作为 你 原生 构建 一 部 分 的 必要 编译 器 ， 那 么 你 不 被 限于 构建 使 用 C 或 者 C++ 编 程 语言 的 源 代 码 。 

用 于 例子 的 源 代 码 由 两 个 C 源 文件 和 C 头 文件 组 成 ， 我 们 在 程序 清单 8-6 中 已 经 复制 了 它们 。 


程序 清单 8-6 《文件 软件 包 源 代码 


helloprint.h: 
void printHello(void) ; 


helloprint.c: 

#include <stdio.h> 

#include "helloprint.h" 

void printHello(void) { 
printf("Hello, World! My first Yocto Project recipe.\n"); 
return; 


} 


hello.c: 

#include "helloprint.h" 

int main() { 
printHello(); 
return(0); 


例如 ， 我 们 假设 你 从 你 创建 了 3 个 文件 的 目录 中 使 用 以 下 命令 创建 名 为 hello-1.0.tgz 并 且 包 含 3 个 文件 的 压缩 tar 包 : 


$ tar cvfz hello-1.0.tgz 


然后 ， 复 制 tar 文 件 到 子 目录 meta-mylayer/recipes-apps/hello/hello-1.0. 中 。 
随后 ， 在 meta-mylayer/recipes-apps/hello 中 创建 名 为 hello 1.0.bb 且 显示 在 程序 清单 8-7 中 的 菜谱 。 


程序 ; 青 单 8- 7 用 于 构建 C 文件 源 包 的 菜谱 


SUMMARY = "Simple Hello World Application" 
DESCRIPTION = "A test application to demonstrate how to create a recipe \ 
by directly compiling C files with BitBake." 


SECTION = "examples" 
PRIORITY = "optional" 


LICENSE = "MIT" 
LIC_FILES_CHKSUM = "\ 
file://S${COMMON LICENSE DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302" 


SRC_URI = "file://hello-1.0.tgz" 
S = "${WORKDIR}" 


do_compile() { 

${CC} -c helloprint.c 

${CC} -c hello.c 

S${CC} -o hello hello.o helloprint.o 
} 


do_install() { 
install -d ${D}${bindir} 
install -m 0755 hello ${D}${bindir} 


构建 系统 为 正确 的 C 编 译 器 自动 设置 变量 CC， 包 括 用 于 机 器 架构 、 系 统 根 、 调 优 参 数 等 的 所 有 必要 标记 。 关 于 这 个 菜谱 要 注意 的 唯一 其 他 事情 是 设 
置 变量 S$。 因 为 默认 是 $fWORKDIR}${PN}-$fPV}， 但 是 我 们 的 tar 包 不 包含 有 具有 包 和 名 和 包 版 本 的 根 目 录 ， 所 以 ,菜谱 必 须 调 整 的 设置 以 便 构建 系统 可 
以 找到 源 。 


这 个 菜谱 构建 引用 ， 并 且 也 自动 化 创建 主要 包 hello。 所 有 其 他 包 是 空 的， 因为 do_install 仅 仅 安 闭 hello 应 用 文件 。 


8.3.2 ”基于 makefile 的 软件 包 


为 了 这 个 例子 ， 我 们 重用 上 个 例子 中 的 3 个 源 文件 ， 并 且 增 加 显示 在 程序 清单 8-8 中 的 makefile 来 构建 软件 包 。 
程序 清单 8-8 makefile 


CC=gcc 
RM=rm 


CFLAGS=-c -Wall 
LDFLAGS= 


DESTDIR= 
BINDIR=/usr/bin 


SOURCES=hello.c helloprint.c 
OBJECTS=S$ (SOURCES: .c=.0) 


EXECUTABLE=hellomake 


-DDO 
$(CC) (CFLAGS) $< -o $@ 


all: $(SOURCES) $ (EXECUTABLE) 


S (EXECUTABLE): $ (OBJECTS) 
$(CC) S$(LDFLAGS) $^ -o SG 


clean: 
S(RM) S(EXECUTABLE) *.o 


install: $ (EXECUTABLE) 


mkdir -p $(DESTDIR) /$(BINDIR) 
install -m 0755 $< $(DESTDIR) /$(BINDIR) 


这 是 一 个 简单 而 典型 的 makefile， 其 设置 了 一 些 指定 C 编 译 器 和 一 些 标记 的 变量 。 使 用 这 个 文件 ， 你 可 以 在 主机 系统 上 构建 软件 包 。 然 
而 ，makefile 不 把 交叉 构建 考虑 在 内 。 


把 makefile 放 进 和 其 他 3 个 源 文件 相同 的 目录 中 ， 并 且 使 用 如 下 命令 创建 tar 包 : 


9 tar --transform "s/*\./hellomake-1.0/" -cvzf hellomake-1.0.tgz 
这 个 命令 不 仅 创 建 讨 缩 的 tar 包 ， 也 以 目录 hellomake-1.0 前 缀 在 包 中 的 文件 来 创建 正确 的 目录 结构 以 便 菜 谱 不 用 必须 调整 变量 。 复 制 tar 包 进 子 目 
=meta-mylayer/recipes-apps/hello/hellomake-1.04, 
然后 在 meta-mylayer/recipes-apps/hellomake 中 创建 显示 在 程序 清单 8-9 中 的 名 为 hellomake_1.0.bb 的 菜谱 。 


程序 清单 8-9 ”用 于 构建 基于 makefile 的 软件 包 的 菜谱 


SUMMARY = "Hello with Makefile" 
DESCRIPTION = "A test application to demonstrate how to create a \ 
recipe for makefile-based project." 


SECTION = "examples" 
PRIORITY = "optional" 


LICENSE = "MIT" 
LIC FILES CHKSUM = "\ 

file: //S{COMMON_LICENSE DIR}/MIT;md5=0835ade698e0bc f£8506ecda2£7b4 £302" 
SRC_URI = "file://${P}.tgz" 


EXTRA_OEMAKE = "'CC=S${CC}' 'RANLIB=S{RANLIB}' 'AR=S{AR}' \ 
'CFLAGS=${CFLAGS} -I${S}/. -DWITHOUT_XATTR' 'BUILDDIR=${S}'" 


do_install () { 


oe runmake install DESTDIR=${D} BINDIR=S{bindir} SBINDIR=S${sbindir} \ 
MANDIR=S${mandir} INCLUDEDIR=${includedir} 


函数 oe runmake 由 do _ compile 任 务 执行 并 且 以 makefile 来 调用 Make 工 具 。 你 通常 必须 通过 设置 EXTRA_OEMAKE 变 量 来 传递 用 于 变量 设置 的 参 
数 到 makefile。 变 量 提供 从 构建 系统 变量 到 被 makefile 使 用 的 变量 和 传统 参数 的 映射 (mapping) 。 


如 果 你 需要 提供 额外 选项 到 CFLAGS 变 量 ， 那 么 你 一 定 不 能 覆 苹 它 ， 因 为 构建 系统 使 用 它 传递 交叉 构建 设置 到 编译 器 。 蔡 代 性 地 ， 使 用 
CFLAGS_prepend = "<flags>" 


来 增加 额外 选项 。 
不 需要 覆盖 do_compile 任 务 。 由 base.bbclass 定 义 的 默认 任务 执行 oe_runmake， 其 对 应 执行 Make 工 具 ， 传 递 EXTRA_OEMAKE 变 量 给 它 。 


然而 ， 你 确实 需要 提供 你 自己 的 do_install 任 务 ， 因 为 由 base.bbclass 定 义 的 默认 什么 也 不 做 。 如 果 makefile 提 供 安 六 目标 ， 那 么 任务 仪 仪 用 参数 来 
调用 oe_runmake， 正 如 在 例子 中 所 显示 的 。 否 则 ， 你 必须 显 式 地 编写 安装 ， 正 如 在 前 面 例子 中 所 显示 的 。 


8.3.3 ”基于 CMake 的 软件 包 


CMake 是 用 于 构建 、 测 试 和 打包 软件 的 开源 跨 平台 构建 系统 。CMake 工 具 套 件 使 用 独立 于 平台 和 编译 器 的 配置 文件 来 控制 和 管理 构建 过 程 。 
CMake 创 建 原 生 makefiles， 甚 至 为 各 种 集成 开发 环境 (Integrated Development Environments, IDE) 创建 工作 区 。 


OpenEmbedded 构 建 系统 用 cmake 类 为 使 用 CMake 的 软件 包 提 供 文 持 。 类 处 理 配置 和 构建 过 程 ， 把 大 部 分 菜谱 缩减 到 仅 有 摘 述 性 元 数据 、 许 可 信 
息 、 源 URI 和 用 于 cmake 类 的 继承 指令 。 程 序 清单 8-10 显 示 了 用 于 构建 Synergy 的 菜谱 ，Synergy 是 允许 通过 本 地 网 络 在 多 个 计算 机 之 间 共 享 键 盘 和 鼠标 


TONS 


的 客 尸 端 -服务 器 应 用 。Synergy 使 用 CMake 来 控制 它 的 构建 过 程 。 显 示 的 菜谱 是 从 OpenEmbedded meta-oe 层 复制 过 来 的 。 





程序 清单 8-10 ”用 于 构建 Synergy 的 菜谱 一 一 synergy 1.3.8.bb 


SUMMARY = "Synergy - control multiple computers with one keyboard and mouse" 
HOMEPAGE = "http://synergy.googlecode.com" 

LIC_FILES_CHKSUM = "file: //COPYING;md5=9772a11e3569985855e2ce450e56£991" 
LICENSE = "GPL-2.0" 

SECTION = "x1i/utils" 


DEPENDS 


"libx11 libxtst libxinerama" 


SRC_URI 


"http://synergy.googlecode.com/files/synergy-${PV}-Source.tar.gz" 
SRC_URI[md5sum] = "3534c65ecfa6e47d7899c57975442 £03" 
SRC_URI[sha256sum] = \ 
"Qafc83e4ed0b46ed497d4229b2b2 854e8d3c581a112£4da05110943edbfacc03" 
S = "S{WORKDIR}/${PN}-${PV}-Source" 
inherit cmake 
do_install() { 


install -d ${D}/usr/bin 
install -m 0755 ${S}/bin/synergy* ${D}/usr/bin/ 


8.3.4 基于 GNU Autotools 的 软件 包 


GNU 构 建 系统 ， 通 党 被 称 为 G6NU Autotools， 已 经 成 为 用 于 开 上 友 可 以 在 类 UNIX 系 统 之 间 移 植 的 应 用 的 事实 标准 。 


开 友 者 频繁 批评 Autotools 复 杂 并 且 难 以 使 用 。 然 而 ， 编 写 可 以 在 大 量 不 同系 统 上 被 编译 的 应 用 是 一 项 复杂 任务 ， 对 于 座 入 陈 系 统 尤 其 如 此 。 
Autotools 可 以 帮助 开 上 友 者 理解 很 多 不 同系 统 的 细节 ， 以 及 它们 在 哪些 方面 仔 在 差异 ， 但 要 求 他 们 提供 一 个 可 能 很 长 的 配置 设置 列表 。 


带 有 Autotools 支 持 而 被 创建 的 软件 包 极 大 地 简化 了 在 不 同系 统 上 构建 包 的 任务 。 通 常 ， 所 有 你 要 做 的 是 运行 配置 脚本 ， 然 后 构建 包 。 大 量 开源 包 使 
用 Autotools 用 于 配置 。OpenEmbedded 构 建 系统 通过 autotools 类 提供 很 大 的 文 持 ， 在 大 部 分 情况 下 ， 它 把 编写 茉 谱 极 大 地 简化 成 了 提供 描述 性 指 
令 、 增 加 源 URI 和 许可 信息 以 及 继承 autotools 类 。 程 序 清单 8-11 显 示 了 构建 nano 编 辑 器 包 的 菜谱 。 





程序 清单 8-11 ”用 于 构建 Nano 编 辑 器 的 菜谱 一 一 nano_2.3.1.bb 


SUMMARY = "GNU nano - an enhanced clone of the Pico text editor" 
DESCRIPTION = "GNU nano - an enhanced clone of the Pico text editor" 


HOMEPAGE = "http://www.nano-editor.org" 
BUGTRACKER = "https://savannah.gnu.org/bugs/?group=nano" 


SECTION = "console/utils" 
PRIORITY = "optional" 


LICENSE = "GPLv3" 
LIC_ FILES CHKSUM = "file://COPYING;md5=f27defele96c2elecd4e0c9be8 967949" 


DEPENDS = "ncurses" 

PV_MAJ = "S{@bb.data.getVar('PV',d,1).split('.') [0]}" 
PV_MIN = "S${@bb.data.getVar('PV',d,1).split('.') [1]}" 
SRC URE = *4 


http: //www.nano-editor.org/dist/v${PV_MAJ}.${PV_MIN}/nano-${PV}.tar.gz" 
SRC_URI[md5sum] = "af09f8828744b0ea0808d6c19a2b4bfd" 
SRC_URI[sha256sum] = "\ 

b7bace9a8e543b8 473 6d6ef5ce5430305746efea3aach24391£692efc6f£3c8d3" 


inherit autotools gettext 
RDEPENDS_S${PN} = "ncurses" 


这 个 菜谱 不 包含 用 于 任何 步骤 的 任何 特殊 设置 。 所 有 东西 都 是 由 autotools 处 理 的 。 关 于 这 个 菜谱 需要 注意 的 仅 有 以 下 : 
- 除了 autotools， 菜 谱 也 继承 gettext 类 。 这 个 类 用 GNU gettext 原 生 语 言 支持 (Native Language Support, NLS) 促进 构建 软件 包 。 
- Nano 是 使 用 ncutses 库 的 控制 台 应 用 。 因 此 ， 菜 谱 声 明 对 其 的 构建 时 和 运行 时 依赖 。 


` 为 了 使 菜谱 更 易于 为 软件 包 的 更 新 版 本 而 升级 ， 不 直接 把 版 本 号 写 入 SRC_URI 是 好 建议 。 因 为 nano 编 辑 器 的 上 游 源 仓库 在 它 的 路 径 中 使 用 部 分 版 
本 号 ， 所 以 菜谱 拆 分 PV 变量 成 它 的 各 部 分 以 创建 版 本 号 。 


为 了 构建 nano 编 辑 器 ， 简 单 地 在 meta-mylayer/recipes-apps/nano 中 创建 名 为 nano 2.3.1.bb 且 显示 在 程序 清单 8-11 中 的 菜谱 ， 并 且 启 动 
BitBake, 


8.3.5 ”外 部 构建 软件 包 

在 一 些 情况 下 ， 你 可 能 需要 构建 系统 包含 已 经 通过 其 他 方法 构建 的 软件 包 ， 并 且 你 被 提供 了 仪 仪 包 仿 二进制 、 配 置 文件 和 文档 等 的 软件 包 。 因 为 你 
没有 源 代 码 ， 所 以 你 不 能 使 用 一 个 获取 源 代码 然后 构建 它 的 菜谱 。 

解决 方案 是 ， 写 获取 二 进 制 包 、 解 压 它 、 跳 过 配置 和 编译 步骤 、 安 濠 包 组 件 、 然 后 重新 打包 它们 以 与 目标 设备 的 根 文 件 系 统 集成 。 

虽然 这 不 是 最 理想 的 过 程 并 且 可 能 导致 兼容 性 问题 ， 但 是 它 可 能 是 仪 有 的 无 颖 集成 这 种 包 的 方法 。 


为 了 集成 外 部 构建 的 软件 包 ，OpenEmbedded 构 建 系统 提供 了 bin_package 类 。 类 使 用 默认 的 do fetch 和 do_unpack 任 务 来 获取 和 解压 它 到 S 目 录 
中 。 它 跳 过 do_configure 和 do_compile 任 务 并 日 定义 了 简单 的 把 文件 从 S$ 复制 到 了 D 目 录 的 do_install 任 务 。 在 复制 后 ， 它 通过 设置 FILES_${PN}="/" 来 创 
建 包 含 所 有 文件 的 单一 包 。 


程序 清单 8-12 显 示 了 使 用 bin_package 的 一 个 样本 菜谱 。 


程序 清单 8-12 使 用 bin_package 的 菜谱 


SUMMARY = "Package the Proprietary Software" 

DESCRIPTION = "A sample recipe utilizing the bin_package class \ 
to package the externally build Proprietary software \ 
package." 


LICENSE = "CLOSED" 


SRC_URI "file://proprietary-${PV}.rpm" 


inherit bin_package 


如 果 原 软件 包 在 被 解压 到 S 目 录 后 具有 和 它 在 目标 上 完全 相同 的 布局 ， 那 么 bin_package 类 可 以 不 做 任何 调整 的 工作 。 


如 果 软 件 包 在 目标 上 要 求 有 不 同 的 布局 ,或 者 你 希望 拆 分 它 为 不 同 的 包 ， 那 么 你 需要 覆 苹 do_install 任 务 并 且 对 应 设置 FILES 变 量 (Bb 
FILES_{PN},， 但 最 终 也 包括 其 他 来 自 PACKAGES 列 表 的 变量 ) 。 


8.4 devtool 


在 本 章 前 面 的 部 分 ,我 们 学 习 了 为 软件 包 写 菜谱 ， 为 它们 创建 层 ， 在 构建 环境 中 包含 屋 ， 以 及 增加 包 到 镜像 目标 ,构建 并 且 最 终 部 署 镜像 的 过 程 。 
这 些 步骤 中 的 大 部 分 都 可 以 通过 使 用 devtool 来 简化 。 


devtool 是 工具 套件 ， 它 在 用 OpenEmbedded 构 建 系统 进行 往返 开发 (round-trip development) 方面 辅助 你 。 它 本 质 上 就 像 瑞 士 军 岂 ， 在 单一 
包 中 提供 最 常 被 用 到 的 工具 。 使 用 --help 选 项 给 了 你 devtool 子 命令 的 程序 清 


$ devtool -help 


usage: devtool [--basepath BASEPATH] [--bbpath BBPATH] [-d] [-q] 
[~-color COLOR] [-—H] 
<subcommand> 


OpenEmbedded development tool 


optional arguments: 
--basepath BASEPATH Base directory of SDK / build directory 


--bbpath BBPATH Explicitly specify the BBPATH, rather than 
getting it 
from the metadata 
-d, --debug Enable debug output 
-q, --quiet Print only errors 
--color COLOR Colorize output (where COLOR is auto, always, 
never) 
-h, --help show this help message and exit 
subcommands: 
<subcommand> 
create-workspace Set up a workspace 
deploy-target Deploy recipe output files to live target machine 
undeploy-target Undeploy recipe output files in live target machine 
build-image Build image including workspace recipe packages 
add Add a new recipe 
modify Modify the source for an existing recipe 
extract Extract the source for an existing recipe 
sync Synchronize the source for an existing recipe 
update-recipe Apply changes from external source tree to recipe 
status Show workspace status 
reset Remove a recipe from your workspace 
search Search available recipes 
upgrade Upgrade an existing recipe 
build Build a recipe 


Use devtool <subcommand> --help to get help on a specific command 


8.4.1 使 用 devtoo| 的 往返 开发 


devtoo| 为 你 创建 和 维护 工作 区 (workspace) 层 ， 它 自动 化 地 把 工作 区 层 和 当前 构建 环境 集成 起 来 。 在 你 可 以 使 用 devtool 用 于 往返 开发 之 前 ， 你 
需要 引用 (source) 构建 环境 ， 正 如 往常 一 样 。 


创建 workspace 层 


$ devtool create-workspace [layerpath] 
在 指定 的 layerpath 中 为 你 创建 新 的 workspace 层 。 如 果 你 省 略 layerpath， 那 么 devtool 在 当前 位 置 创 建 名 为 workspace 的 层 。 被 创建 的 workspace 
层 包含 conf/layer.conf 文 件 。devtool 自 动 化 地 增加 层 到 当前 构建 环境 的 conf/bblayers.conf 文 件 中 ， 除 非 你 指定 --create-only 选 项 。 


只 有 当 你 希望 显 式 地 指定 layerpath 时 ， 你 才 必须 使 用 create-workspace 命 令 ， 因 为 如 果 还 没有 用 于 你 当前 构建 环境 的 workspace 层 存在 ， 其 他 
devtool 命 令 会 自动 创建 它 。 


对 于 同一 个 构建 环境 来 说 ， 同 一 时 刻 你 仅仅 可 以 拥有 一 个 由 devtool 维 护 的 workspace 层 。 如 果 你 在 已 经 有 了 工作 区 的 构建 环境 中 再 次 使 用 create- 
workspace 命 令 ， 那 么 devtool 创 建新 层 并 且 对 应 修改 conf/bblayers.conf。 然 而 ， 它 不 删除 你 以 前 的 workspace 层 。 


文件 conf/devtool.conf 包 含 用 于 devtool 的 配置 设置 ， 特 别 是 到 workspace 层 的 路 径 。 
增加 新 菜谱 到 workspace 层 


为 软件 包 增 加 新 菜谱 到 workspace 层 ， 使 用 命令 
S devtool add <recipe-name> <source-path> 


其 中 ，recipe-name 是 菜谱 的 名 字 ，source-path 是 到 软件 包 的 源 的 路 径 。 如 果 你 不 显 式 地 创建 workspace 层 ， 那 么 当 使 用 add 命 令 时 ，devtool 将 
隐 陈 地 创建 名 为 workspace 的 层 。 


devtool 在 工作 区 层 作为 recipes/<recipe-name>/<recipe-name>.bb 来 创建 菜谱。 在 菜谱 内 的 SRC_URI 变 量 是 空 的 ， 因 为 devtool 创 建 带 有 被 设 
置 成 指向 到 source-path 的 EXTERNALSRC 的 append/<recipe-name>.bbappend 文 件 。 如 果 devtool 不 能 找到 被 包含 在 包 源 中 的 许可 信息 ， 那 么 它 设 
ESLICENSE="CLOSED"#QLIC_FILES CHKSUM=”， 这 人 允许 菜谱 在 即使 没有 许可 信息 的 情况 下 也 可 构建 。 对 应 地 ，devtool 也 尝试 计算 出 如 何 构建 源 和 
设置 菜谱 。 对 于 使 用 CMake 和 Autotools 的 软件 包 ， 它 包含 各 个 类 。 对 于 基于 makefile 的 软件 包 ， 它 为 do_configure0、do_compile0 和 do install(0 任 
务 设置 桩 (stub) 。 昌 然 在 大 部 分 情况 下 ，devtool 产 生 可 工作 的 菜谱 ， 但 是 你 将 可 能 需要 调整 它 以 使 其 完全 运转 起 来 。 


如 果 你 可 以 从 远程 位 置 访问 包 ， 那 么 可 以 使 用 
S devtool add <recipe-name> <source-path> -f <source-uri> 


来 从 <src-uri> 直 接 获 取 源 并 且 解 压 它们 到 本 地 <source-path>。 例 如 


S devtool add nano sources/nano \ 
-f http://www.nano-editor.org/dist/v2.5/nano-2.5.1.tar.gz 


从 nano 编 辑 器 下 载 站 点 获取 nano-2.5.1.tar.gz 源 tar 包 ， 并 且 解 压 它们 到 sources/nano 目 录 ， 在 其 中 它 初始 化 了 Git 仓 库 。 它 也 在 
workspace/recipes/nano 中 创建 菜谱 nano.bb， 显 示 在 程序 清单 8-13 中 (我们 仅仅 重新 格式 化 了 菜谱 的 内 容 以 使 得 它 适 应 本 书 的 页 面 ) 。 


程序 清单 8-13 ”用 devtool 创 建 的 用 于 nano 编 辑 器 的 菜谱 


Recipe created by recipetool 

This is the basis of a recipe and may need further editing in order 
to be fully functional. 

(Feel free to remove these comments when editing. ) 


WARNING: the following LICENSE and LIC_FILES_CHKSUM values are 
best guesses - it 1S your responsibility to verify that the values are 
complete and correct. 


NOTE: multiple licenses have been detected; if that is correct you 
should separate these in the LICENSE value using & if the multiple 
licenses all apply, or | if there 

is a choice between the multiple licenses. If in doubt, check the 


+ HE HE HS HF HS HS SF HS HF HS HS HS 


# accompanying documentation to determine which situation is applicable. 
LICENSE = "GPLv3 Unknown" 
LIC_FILES_CHKSUM = " \ 

file: //COPYING; md5=f27defele96c2elecd4e0c9be8967949 \ 

file: //COPYING. DOC; md5=ad1419ecc56e060ecc£8184a87c4285E" 


SRC_URI = "http://www.nano-editor.org/dist/v2.5/nano-2.5.1.tar.gz" 
SRC_URI[md5sum] = "f£25c7da9813ae5f1df7e5dd1072de4ce" 
SRC_URI[sha256sum] = 
"e06fca01lbf183f4d53laa65a28d£fc0e2d10185239909eb3de797023£3453bde" 


S = "S{WORKDIR}/nano-2.5.1" 


NOTE: the following prog dependencies are unknown, ignoring: makeinfo 
NOTE: the following library dependencies are unknown, ignoring: 
ncursesw ncursesw ncurses curses curses magic z 

(this 1s based on recipes that have previously been built and packaged) 
NOTE: if this software is not capable of being built in a separate 
build directory from the source, you should replace autotools with 
autotools-brokensep in the inherit line 

inherit pkgconfig gettext autotools 


+ HHS FS FS FS HF 


# Specify any options you want to pass to the configure script using 
# EXTRA _OECONF: 
EXTRA OECONF = "" 


注意 ， 变 量 SRC_URI 被 设置 成 用 -f (--fetch) 选项 指定 的 URI。 而 且 ，devtool 创 建 追 加 文件 workspace/append/nano.bbappend， 显 示 在 程序 清 
单 8-14 中 。 
程序 清单 8-14 ”外 部 源 nano.bbappend 


inherit externalsrc 
EXTERNALSRC = "/run/media/rstreif/YoctoDevelop/projects/kc/src/nano" 


# initial rev: c0516cb63fa0d376f8laec4e75a9c3cbhd80823cb 


追加 文件 覆 苹 菜谱 的 SRC_URI 设 置 ， 允 许 你 修改 源 而 不 用 改变 菜谱 。 
构建 菜谱 
在 你 已 经 增加 了 菜谱 、 审 查 了 它 并 且 最 终 做 了 一 些 调整 后 ， 你 可 以 使 用 devtoo| 来 构建 它 : 


S devtool build <recipe-name> 


其 本 质 上 用 来 自 构建 环境 的 所 有 设置 调用 bitbake<recipe-name> ， 这 些 设置 包括 用 于 make 的 并 行 度 (parallelism) 选项 。 你 可 以 通过 增加 -s (-- 
disable-parallel-make) 到 构建 命令 来 禁用 并 行 make。 


部 署 包 到 目标 系统 


现在 你 可 以 部 署 新 鲜 出 炉 的 构建 包 到 目标 系统 上 。 目标 系 统 可 以 是 实际 硬件 或 者 QEMU。 唯 一 的 要 求 是 ， 目 标 系统 必须 是 运行 着 安全 Shell (SSH) 


的 服务 器 。 命 令 


S devtool deploy-target <recipe-name> [user@]target-host[:destdir] 


由 do _install() 任 务 把 所 有 已 安 六 文件 传输 到 根 文 件 系统 中 。 你 可 以 指定 替代 的 用 户 名 和 文件 复制 到 的 目的 目录 。 
一 些 选项 修改 命令 的 行为 : 
-nm--dry-run: 这 个 选项 仅仅 列 出 要 被 部 署 的 文件 而 不 实际 复制 它们 到 目标 系统 。 


. -Si--Show-status: 如 果 你 使 用 这 个 选项 ， 那 么 命令 将 展示 状态 和 过 程 输出 。 


- -c,--no-host-check: 跳 过 SSH 主 机 密 钥 验 证 。 
从 目标 系统 移 除 包 
与 deploy-target 类 似 ， 你 使 用 命令 
S devtool undploy-target <recipe-name> [user@]target-host 
来 从 目标 系统 中 删除 用 deploy-target 部 署 的 文件 。 如 果 在 部 署 时 你 使 用 了 destdir， 那 么 devtool 记 住 它 并 且 从 那个 目录 中 移 除 文件 。 
用 于 undeploy-target 命 令 的 选项 和 用 于 deploy-target 命 令 的 选项 是 完全 相同 的 。 
构建 镜像 
用 devtool， 你 也 可 以 构建 包含 所 有 来 自 workspace 层 的 菜谱 的 镜像 。 命 令 


S devtool build-image <image-name> 
通过 增加 来 自 工作 区 的 菜谱 到 IMAGE INSTALL append 来 用 其 扩展 由 <image-name> 指 定 的 镜像 ， 然 后 启动 BitBake 以 构建 镜像 。 


展示 工作 区 信息 


a 
4 


S devtool status 
打印 关于 workspace 层 的 状态 信息 。 


Proxy Error 


The proxy server received an invalid response from an upstream server. 
The proxy server could not handle the request GET /resource/readBook. 


Reason: Error reading from remote server 


8.5 总 结 
一 开始 ， 编 写 菜谱 看 起 来 是 困难 的 ， 但 是 随 着 实践 而 变 得 更 加 容易 。 在 OpenEmbedded 网 站 上 ， 差 不 多 有 数 干 菜谱 可 供 你 仔细 研究 和 学 习 。 层 索引 
和 搜索 功能 使 其 容易 找到 已 经 接近 于 你 正在 尝试 完成 的 东西 的 菜谱 。 
在 本 章 ， 我 们 
. 研究 了 菜谱 的 结构 并 且 讨 论 了 典型 变量 。 
解释 了 菜谱 命名 和 格式 惯例 。 


提供 了 一 步 一 步 的 关于 如 何 写 你 自己 的 菜谱 的 指导 。 


- 解释 了 如 何 使 用 devtool 用 于 快速 往返 开发 和 轻松 地 工作 在 现 有 菜谱 以 及 它们 构建 的 软件 包 上 。 
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第 9 章 “内核 菜谱 


如 果 没 有 定制 Linux 内 核 来 完整 支持 硬件 ， 那 么 嵌入 式 Linux 项 目 将 不 是 名 副 其 实 的 。 虽 然 Linux 不 是 一 个 微 内 核 (microkernel) 架构 趾 ， 但 是 Linux 
是 模块 化 的 。 功 能 性 要 么 被 编译 进 Linux 内 核 中 ， 要 么 作为 可 加 载 内 核 模块 loadable kernel module) 在 运行 时 被 插入 到 内 核 中 。 从 模块 化 的 角度 来 
看 ，Linux 内 核 类 似 于 微 内 核 架 构 。 然 而 ， 在 微 内 核 中 ， 设 备 驱动 和 其 他 非 内 核 核心 组 成 部 分 的 内 核 代码 是 作为 独立 但 具有 特权 的 进程 来 执行 的 。 在 这 一 
点 上 ，Linux 内 核 和 微 内 核 是 不 相似 的 。 在 Linux 内 核 中 ， 模 块 和 设备 驱动 代码 总 是 在 内 核 的 上 下 文中 执行 ， 这 使 得 Linux 内 核 称 为 单 内 核 。 因 为 这 种 架 
构 ，Linux 模 块 拥有 对 所 有 内 核 数据 结构 的 访问 ， 不 管 是 好 是 坏 ， 它 不 需要 使 用 微 内 核 所 必须 使 用 的 内 核 进 程 间 通信 (Interprocess 
Communication, IPC) 。 然 而 ， 进 程 间 通 信 对 所 有 Linux 内 核 模 块 都 是 可 用 的 。 


你 是 希望 编译 内 核 功能 性 到 内 核 中 还 是 使 其 成 为 运行 时 可 加 载 模块 ， 这 依赖 于 你 需要 为 你 的 项 目 所 考虑 的 各 种 因素 : 


作为 内 核 模 块 的 可 用 性 : 如 果 功 能 性 是 作为 内 核 模 块 来 提供 的 ， 那 么 你 有 这 样 两 个 选择 一 一 直接 编译 模块 代码 到 内 核 中 或 者 编译 它 成 为 可 以 在 内 
核 运 行 时 被 加 载 和 印 载 的 可 加 载 模 块 。 如 果 你 选择 编译 内 核 模 块 到 内 核 中 ， 那 么 在 运行 时 它 不 能 被 邱 载 。 然 而 ， 一 些 功能 性 ， 因 为 它 的 技术 本 质 ， 永 远 
不 能 在 运行 时 被 加 载 。 如 果 你 的 项 目 要 求 那样 的 功能 性 ， 那 么 你 必须 编译 它 到 内 核 中。 


. 内 核 内 存 占 用 : 编译 进 内 核 的 功能 性 越 少 就 意味 着 可 以 快速 从 存储 介质 中 加 载 的 更 小 内 核 。 
: 局 动 时 | 间 : 有 具有 更 少 的 被 编译 进 内 核 的 驱动 的 更 小 内 核 意 味 着 在 内 核 启 动 时 更 少 的 初始 化 ， 这 有 助 于 实现 一 个 更 快 的 启动 时 间 。 


- 局 动 时 的 硬件 支持 : 因为 内 核 模块 在 内 核 已 经 启动 了 用 户 空间 之 后 才 被 插入 到 Linux 内 核 中 ， 所 以 在 内 核 启 动 时 就 需要 可 用 的 所 有 硬件 支持 ， 例 如 
硬盘 以 及 最 终 的 网 络 硬件 ， 都 必须 被 编译 进 内 核 中 。 替 代 性 地 ， 你 可 以 使 用 初始 内 存 磁 盘 (initial ramdisk, initrd) 镜像 来 探测 硬件 ， 正 如 大 部 分 Linux 桌 


. 升级 能 力 : 在 嵌入 式 设备 交付 之 后 ， 硬 件 驱动 可 能 需要 升级 。 如 果 设 备 驱 动 是 被 编译 进 内 核 的 ， 那 么 整个 内 核 必 须 被 升级 ， 在 不 重启 系统 的 情况 
下 这 是 不 可 能 实现 的 。 如 果 设 备 驱 动 是 作为 内 核 模 块 来 加 载 的 ， 那 么 旧 模 块 可 以 在 运行 时 被 卸载 并 且 新 模块 可 以 被 加 载 以 蔡 换 旧 模 块 。 


在 本 章 中 ， 我 们 解释 如 何 用 Yocto 项 目 来 使 用 Linux 内 核 的 配置 系统 以 定制 内 核 ， 用 内 核 菜 谱 构建 内 核 的 不 同方 法 ， 如 何 向 内 核 打 补 丁 以 及 如 何 构建 
树 外 内 核 模块 (out-of-tree kernel module) 。 


[1] 在 此 ， 我 们 不 深入 讨论 微 内 核 架 构 对 比 单 内 核 (monolithic kernel) 架构 的 长 处 和 短处 。Linus Torvalds 和 Minix OS 创 造 者 Andrew Tanenbaum 之 间 对 此 有 
一 个 非常 有 趣 的 辩论 : https://groups.google.com/forum/?fromgroups=#! topic/comp.os.minix/wlhw16QWItI%5B1-25%5D. & ARH ILILAK LAL EM FAK 
事实 的 ， 但 是 它 提 供 了 对 这 两 种 架构 的 优点 和 缺点 的 良好 见解 。 


9.1 内核 配置 


Linux 内 核 提供 了 它 自 己 的 配置 系统 ， 通 弟 被 称 为 kconfig。Kkconfig 本 质 上 是 以 树 结构 组 织 的 配置 数据 库 。 所 有 配置 选项 合并 进位 于 内 核 源 树 的 顶级 
目录 中 的 单一 文件 .config。 内 核 的 构建 系统 使 用 那个 文件 来 传送 配置 到 所 有 内 核 源 文 件 。 作 为 文件 名 首 字 母 的 点 (.) 使 得 这 个 文件 成 为 UNIX 系 统 上 的 
隐藏 文件 。 你 必须 使 用 ls-a 以 便 在 目录 程序 清单 中 看 到 它 。 虽 然 你 可 以 直接 使 用 文本 编辑 器 来 编辑 那个 文件 ， 但 这 样 做 是 不 推荐 的 。 在 一 个 逐 行 的 平面 文 
件 中 包含 了 超过 5500 个 配置 设置 ， 这 可 能 是 内 核 开 友 者 决定 让 .config 成 为 隐藏 文件 的 原因 之 一 吧 。 


:Config 文件 通 弟 是 家 自动 化 地 创建 的 ， 它 要 么 是 来 目 默 认 平 台 配 置 文件 ， 要 么 是 来 目 用 于 特定 系统 的 现 有 配置 文件 。 如 果 你 希望 编辑 它 ， 那 么 Linux 
内 核 配 置 系 统 提供 了 用 于 它 的 菜单 编辑 器 。 这 些 编辑 器 也 识别 配置 设置 的 依赖 性 (dependency) 和 互 依赖 性 (interdependency) 。 


如 果 你 选择 依赖 于 一 个 或 者 更 多 其 他 设置 的 配置 设置 ， 那 么 ， 如 果 那 些 被 依赖 的 设置 还 没有 被 设置 ， 编 辑 器 也 上 自动 选择 它们 。 


9.1.2 ”配置 片段 
当然 ， 你 不 希望 每 次 重新 构建 内 核 的 时 候 都 使 用 菜单 编辑 器 来 手动 修改 内 核 配 置 。 对 那个 目的 来 说 ， 构 建 系统 提供 了 使 用 菜谱 来 合并 部 分 配置 
(partial configuration) (被 称 为 配置 片段 ) 到 .config 文 件 的 机 制 。 图 9-1 示 例 了 配置 片段 (configuration fragment) 的 概念 。 


配置 片段 是 这 样 一 些 文件 ， 它 们 包含 正如 你 在 .config 文 件 中 找到 的 一 行 或 者 多 行内 核 配置 设置 一 一 例如 ，CONFIG_SMP=n。 然 后 ， 你 可 以 简单 地 
增加 那些 文件 到 内 核 菜谱 的 SRC_URI。 因 为 内 核 菜谱 经 常 是 由 Yocto 项 目 、OpenEmbedded 或 者 板 支 持 包 层 所 提供 的 ， 所 以 我 们 推荐 你 创建 自己 的 层 并 
且 使 用 到 内 核 菜 谱 的 追加 文件 而 不 是 直接 使 用 在 那个 原始 层 中 的 菜谱 。 


内 核 tar 包 或 者 Git 仓 库 





配置 片段 
# 


# Main Defconfig 

# 

CONFIG_X86_32=y 

CONFIG_X86=y 
CONFIG_INSTRUCTION_DECODER=y 
CONFIG_OUTPUT_FORMAT="e1f32-1386" 
CONFIG_LOCKDEP_SUPPORT=y 
CONFIG_STACKTRACE SUPPORT=y 
CONFIG_HAVE_LATENCYTOP_SUPPORT=y 
CONFIG_MMU=y 
CONFIG_NEED_SG_DMA_LENGTH=y 
CONFIG_GENERIC_TSA_DMA=y 
CONFIG_GENERIC_BUG=y 


.Config 内 核 源 树 


linux 
# CONFIG_64BIT is not set arch 


CONFIG_X86_32=y block 
CONFIG_X86=y COPYING 
CONFIG_INSTRUCTION_DECODER=y CREDITS 
CONFIG_OUTPUT_FORMAT="el1f32-1386" crypto 

CONFIG _LOCKDEP_SUPPORT=y Documentation 
CONFIG_STACKTRACE SUPPORT=y drivers 
CONFIG_HAVE_LATENCYTOP_SUPPORT=y firmware 
CONFIG_MMU=y fs 
CONFIG_NEED_SG_DMA_LENGTH=y include 


CONFIG_GENERIC_ISA_DMA=y init 
CONFIG_GENERIC_BUG=y ipc 内 核 镜像 
CONFIG_GENERIC_HWEIGHT=y Kbuild 


b 

# Kernel Performance Events 
# And Counters 

# 

CONFIG_PERF_EVENTS=y 
CONFIG_VM_EVENT_COUNTERS=y 
CONFIG_PCI_QUIRKS=y 
CONFIG_SLUB_DEBUG=y 


CONFIG_ARCH_MAY_HAVE_PC_FDC=y 
CONFIG_RWSEM_XCHGADD_ALGORITHM=y 
CONFIG_GENERIC_CALIBRATE_DELAY=y 
CONFIG_ARCH_HAS_CPU_RELAX=y 
CONFIG_ARCH_HAS_CACHE_LINE_SIZE=y 
CONFIG_ARCH_HAS_CPU_AUTOPROBE=y 
CONFIG_HAVE_SETUP_PER_CPU_AREA=y 


Kconfig 
kernel 

lib 
MAINTAINERS 
Makefile 
mm 

net 


README 
REPORTING-BUGS 
samples 


CONFIG_NEED_PER_CPU_EMBED_FIRST_CHUNK=y 
CONFIG_NEED_PER_CPU_PAGE_FIRST_CHUNK=y 
CONFIG_ARCH_HIBERNATION_POSSIBLE=y 


CONFIG_COMPAT_BRK=y 


# 


# Graphics support 

# CONFIG_AGP is not set 
CONFIG_VGA_ARB=y 
CONFIG_VGA_ARB_MAX_GPUS=16 





CONFIG_ARCH_SUSPEND_POSSIBLE=y 
# CONFIG_ZONE_DMA32 is not set 
# CONFIG_AUDIT_ARCH is not set 


图 9-1 配置 片段 


我 们 在 第 3 章 中 解释 了 创建 层 。 从 一 个 已 初始 化 的 构建 环境 内 使 用 


S yocto-layer create ypbook 


Scripts 
security 
sound 
tools 
usr 

TITE 





为 你 创建 基础 的 层 结构 。 增 加 你 自己 的 新 层 到 构建 环境 的 conf/bblayers.conf 中 的 BBLAYERS 变 量 ( 见 程序 清单 9-1) 。 


程序 清单 9-1 <builddir>/conf/bblayers.conf 


# LAYER _CONF_VERSION is increased each time build/conf/bblayers.conf 
# changes incompatibly 
LCONF_VERSION = "6" 


BBPATH = "${TOPDIR}" 
BBFILES ?= "" 


BBLAYERS ?= " \ 
S{HOME}/yocto/poky/meta \ 
S{HOME}/yocto/poky/meta-yocto \ 
S{HOME}/yocto/poky/meta-yocto-bsp \ 
S{HOME}/yocto/build/meta-ypbook \ 


" 


BBLAYERS_NON_REMOVABLE ?= " \ 
S{HOME}/yocto/poky/meta \ 
S{HOME}/yocto/poky/meta-yocto \ 


" 


现在 为 内 核 追 加 文件 创建 目录 并 且 为 配置 片段 文件 创建 一 个 子 目录 : 


9 mkdir -p recipes-kernel/linux 
$ mkdir -p recipes-kernel/linux/files 
增加 文件 smp.cfg 和 内 核 追 加 文件 到 目录 recipes-kernel/linux， 如 程序 清单 9-2 所 示 。 


程序 清单 9-2 配置 片段 


recipes-kernel/linux/files/smp.cfg: 

# Disable SMP 

CONFIG SMP=n 
recipes-kernel/linux/linux-yocto_3.19.bbappend: 
# Include kernel configuration fragment 


FILESEXTRAPATHS prepend := "S{THISDIR}/files:" 
SRC_URL += "file://smp.cfg" 


内 核 追 加 文件 的 名 字 依 赖 于 当 构 建 virtual/kernel 时 构建 环境 所 用 到 的 内 核 版 本 。 你 可 以 从 内 核 构 建 输出 中 找到 名 字 。 在 我 们 的 例子 中 ， 内 核 菜谱 是 
linux-yocto 3.19.bb。 因 此 ， 我 们 创建 的 追加 文件 是 linux-yocto 3.19.bbappend。 为 了 使 获取 器 能 找到 文件 mp.cfg， 到 它 的 路 径 需要 被 增加 到 
FILESEXTRAPATH 变 量 。 在 我 们 的 例子 中 ， 我 们 简单 地 把 文件 放 在 和 内 核 追加 文件 相同 的 目录 中 。 一 个 菜谱 或 者 菜谱 追加 文件 的 路 径 可 以 通过 使 用 
THISDIR 变 量 来 引用 。 


现在 可 以 使 用 


S bitbake -C fetch virtual/kernel 


来 重新 构建 内 核 。 
这 一 次 ， 我 们 显 陈 地 希望 获取 内 核 源 ， 它 现在 包含 我 们 的 配置 片段 。 在 BitBake 完 成 构建 内 核 以 后 ， 你 可 以 使 用 QEMU 测 试 结 果 。 


对 于 前 面 的 例子 ， 我 们 手动 创建 了 包含 配置 片段 的 文件 。 如 果 你 正在 变更 很 多 配置 选项 ， 特 别 是 如 果 依 赖 设 置 是 由 菜单 编辑 器 自动 司 用 的 ， 那 么 那 
种 配置 片段 可 能 将 难以 退 踩 。 


为 了 便于 创建 配置 片段 的 任务 ， 构 建 系统 提供 了 diffconfig 命 令 ， 它 比较 新 旧 配 置 并 且 创 建 配 置 片段 。 在 用 菜单 编辑 器 编辑 了 配置 后 ， 执 行 : 
S$ bitbake -C diffconfig virtual/kernel 


命令 把 配置 片段 放 进 $fWORKDIR}。 


在 你 已 经 创建 了 配置 片段 并 且 增 加 它 到 你 的 菜谱 之 后 ， 你 可 以 使 用 内 核 工 具 的 配置 验证 来 检查 内 核 配置 : 


S bitbake -C kernel_configcheck -f virtual/kernel 


-C 选 项 使 用 于 kernel_configcheck 的 共享 状态 缓存 失效 以 强制 运行 它 ， 即 使 BitBake 在 之 前 执行 过 它 。 如 果 你 的 内 核 配 置 中 有 任何 问题 ， 那 么 构建 
系统 把 问题 通知 给 你 。 


9.2 和 内核 补丁 


用 菜谱 应 用 补丁 到 内 核 源 和 用 菜谱 为 一 般 软 件 包 应 用 补丁 没有 不 同 。 如 果 你 已 经 有 被 格式 化 过 的 补丁 文件 ， 那 么 简单 地 提供 文件 并 且 增 加 它 到 用 于 
内 核 菜 谱 的 追加 文件 的 SRC_URI。 


为 了 从 内 核 构 建 目 录 中 的 已 修改 内 核 源 中 创建 补丁 ， 请 遵循 这 些 概述 了 用 于 新 内 核 驱动 模块 的 工作 流 的 步 又 : 


1. 改 变 到 内 核 源 目录 。 改 变 你 的 工作 目录 到 内 核 源 目录 。 内 核 源 目 录 可 能 有 点 难 找 。 然 而 ， 和 任何 菜谱 一 样 ， 变 量 ${S} 指 向 源 目录 。 对 于 内 核 菜 
谱 ，${S} 被 设置 成 STAGING KERNEL DIR}。 为 了 找到 内 核 源 目录 ， 使 用 命令 : 


$ bitbake -e virtual/kernel | grep STAGING_KERNEL_DIR 
然后 使 用 以 上 输出 来 改变 到 内 核 源 目录 。 蔡 代 性 地 ， 你 可 以 使 用 
S bitbake -c devshell virtual/kernel 


它 在 内 核 源 目录 中 打开 另 一 个 终端 窗口 。 
2. 增 加 /修改 内 核 源 文件 。 对 于 这 个 例子 ,我 们 增加 简单 设备 驱动 到 内 核 。 编 辑 /添加 文件 ， 如 下 所 示 : 


drivers/misc/Kconfig (add to the end of the file): 
config YP_DRIVER 
tristate "Yocto Project Test Driver" 
help 
This driver does nothing but print a message. 


drivers/misc/Makefile (add to the end of the file): 
obj-$(CONFIG_YP_ DRIVER) += yp-driver.o 


drivers/misc/yp-driver.c (add new file): 
#include <linux/module.h> 


static int __init yocto_testmod_init (void) 


{ 


pr_info("Hello Kernel from the Yocto Project!"); 


} 
static void __exit yocto_testmod_exit (void) 
{ 
pr_info("Gone fishing. I'll be back!"); 
} 


module_init (yocto_testmod_init) ; 
module_exit (yocto_testmod_exit) ; 


MODULE_AUTHOR("Rudolf Streif <rudolf.streif@gmail.com") ; 
MODULE_DESCRIPTION("Yocto Project Test Driver"); 
MODULE_LICENSE("GPL") ; 


3. 组 织 和 提交 变更 。Yocto 项 目 内 核 是 从 Git 仓 库 检 出 的 。 因 此 ， 你 可 以 简单 地 使 用 Git 来 创建 补丁 : 


9 git status 
S git add 
S git commit -m "Added Yocto Project Driver" 


© 


(CÈ: 替代 性 地 ， 你 可 能 希望 使 用 git commit-s 来 把 签署 (signed-offby) 消息 包含 进补 丁 中 。) 


4. 创 建 补丁 文件 。 现 在 再 次 使 用 Git 来 从 内 核 源 的 顶级 目录 中 创建 补丁 文件 : 
S git format-patch -n HEAD^ 


它 创 建文 件 0001-Added-Yocto-Project-Driver.patch。 


5. 移 动 补 丁 文件 到 你 的 层 。 复 制 或 者 移动 补丁 文件 0001-Added-Yocto-Project-Driver.patch 到 我 们 在 前 面 步骤 创建 的 层 的 recipes- 
kernel/linux/files 目 录 。 


6. 创 建 配 置 瞩 段 。 因 为 我 们 正在 增加 一 个 新 驱动 ， 所 以 我 们 需要 用 配置 片段 局 用 它 : 


recipes-kernel/linux/files/yp-driver.cfg: 
# Enable Yocto Project Driver 

CONFIG _MISC_DEVICES=y 

CONFIG _YP_DRIVER=y 


7. 增 加 配置 片段 和 补丁 到 菜谱 。 现 在 需要 增加 配置 片段 和 补丁 到 我 们 在 前 面 步 骤 中 创建 的 菜谱 配置 文件 。 


recipes-kernel/linux/linux-yocto_3.19.bbappend: 

# Include kernel configuration fragment and patch 
FILESEXTRAPATHS prepend := "S{THISDIR}/files:" 

SRC_URI += "file://smp.cfg" 

SRC_URI += "file://yp-driver.cfg" 

SRC_URL += "file://0001-Added-Yocto-Project-Driver.patch" 


8. 构 建 内 核 。 用 以 下 命令 来 构建 内 核 : 
S bitbake -C fetch virtual/kernel 


现在 ， 你 可 以 通过 运行 QEMU 并 且 人 在 dmesg 中 寻找 驱动 的 局 动 消息 来 验证 结果 。 人 在 以 root 登 录 后 ， 执 行 


# dmesg | grep "Hello Kernel" 


HIF Rmx TREANA SIR NMSRANAIRITh). Am, NAA ERRAN, RABRERARAMAANAIRTHT . 
对 于 可 以 在 运行 时 被 加 载 的 模块 ， 你 可 以 以 树 外 模式 编译 模块 。 我 们 将 在 9.4 节 解释 如 何 这 样 做 。 


9.3 AGRE 


Poky 友 行 版 指定 了 如 何 用 提供 了 必要 指令 的 菜谱 像 类 似 构 建 任何 其 他 软件 包 一 样 构建 Linux 内 核 。 构 建 和 打包 Linux 内 核 的 复杂 性 ， 特 别 是 为 跨 目标 
构建 和 打包 ， 被 内 核 类 所 隐藏 。 类 kernel.bbclass 是 主要 的 类 ， 它 从 各 种 其 他 类 继承 。 内 核 菜谱 从 Kernel 继 承 ， 它 简化 开 友 内 核 菜 谱 成 数 行 代码 。 


Yocto 项 目 维护 了 自己 的 内 核 基 础 设施 ， 它 由 用 于 内 核 源 和 元 数据 (例如 配置 、 配 置 片段 和 补丁 ) 的 仓库 构成 。 所 有 Yocto 内 核 一 一 也 就 是 ， 用 于 
QEMU 机 器 的 内 核 一 一 以 及 由 Poky 提 供 的 板 支 持 包 是 从 那个 内 核 仓库 构建 出 来 的 。 很 多 公司 正在 使 用 Yocto 项 目 内 核 用 于 它们 的 板 支 持 包 。 


接 下 来 的 部 分 详细 说 明 如 何 开发 用 于 使 用 任何 内 核 树 来 构建 Linux 内 核 的 菜谱 。9.3.2 小 节 解 释 了 Yocto 项 目 内 核 基础 设施 和 你 可 以 如 何 使 用 它 来 用 于 
你 的 项 目 。 


9.4 树 外 模块 


当然 ， 构 建 内核 模 块 的 最 简单 方法 是 入 树 。 模 块 的 源 代码 已 经 被 集成 进 了 Linux 内 核 源 树 ， 只 要 为 内 核 kconfig 配 置 工 具 正确 设置 了 模块 ， 那 么 构建 
内 核 模 块 仪 仪 是 通过 配置 参数 启用 它 轨 了。 


然而 ， 那 不 忌 是 一 个 选项 。 你 可 能 已 经 收 到 了 作为 源 包 的 模块 的 源 代码 ， 这 对 由 硬件 厂商 提供 的 设备 驱动 来 说 是 常见 的 。 即 使 对 你 自己 的 模块 ， 你 
也 可 能 选择 树 外 构建 而 不 是 集成 它们 的 源 代码 到 Linux 内 核 源 树 。 为 了 那个 目的 ,构建 系统 提供 了 module 类 ， 它 包含 用 于 构建 树 外 模块 的 大 部 分 逻 


m, 


[1] 尽管 如 此 ， 如 果 可 能 ， 总 是 尝试 提交 你 的 内 核 模块 上 游 到 Linux 内 核 源 。 一 旦 到 了 上 游 ， 你 的 模块 将 自动 由 内 核 社区 在 各 个 内 核 版 本 中 维护 。 


9.4.1 开发 内 核 异 块 


如 果 你 确实 编写 了 目 己 的 内 核 模块 ， 那 么 ， 当 然 ， 你 负责 源 文件 。 这 人 允许 你 编写 makefile， 以 便 模 块 类 可 以 直接 使 用 它 而 不 用 对 菜谱 中 的 编译 和 安 
六 函数 做 任何 修改 。 


Yocto 项 目 提 供 了 关于 一 个 模块 的 简单 例子 ， 该 模块 包括 一 个 C 源 文件 、 一 个 许可 文件 以 及 makefile 和 用 于 构建 模块 的 一 个 对 应 的 菜谱 。 你 可 以 在 以 
下 找到 这 个 例子 : 


poky/meta-skeleton/recipes-kernel/hello-mod 


菜谱 是 简单 直接 的 。 为 了 便利 性 ， 我 们 复制 它 到 程序 清单 9-13 中 。 


程序 清单 9-13 ”模块 Recipe (hello-mod 0.1.bb) 


SUMMARY = "Example of how to build an external Linux kernel module" 
LICENSE = "GPLv2" 
LIC_FILES CHKSUM = "file://COPYING;md5=12f£884d2aelff87c09e5b7ccc2c4ca7e" 


inherit module 


PR = "r0" 

Py = 0 1 

SRC_URI = "file://Makefile \ 
file://hello.c \ 
file://COPYING \ 

S = "S{WORKDIR}" 


# The inherit of module.bbclass will automatically name module packages 
# with "kernel-module-" prefix as required by the oe-core build 
# environment. 


正如 你 为 任何 菜谱 所 做 的 ， 你 必须 提供 SUMMARY、LICENSE、LIC_FILES_CHKSUM 和 SRC_URI。 例 如 ， 后 者 仅 仪 包含 由 菜谱 内 空间 提供 的 3 个 文 
件 。 当 然 ， 如 果 你 有 更 复杂 的 模块 ， 那 么 你 会 结构 化 和 打包 源 文 件 。 该 示例 也 设置 了 PV， 而 严格 来 说 ， 它 是 匈 余 的 ， 因 为 构建 系统 从 菜谱 文件 的 名 字 中 
获取 它 。 菜 谱 从 模块 类 中 继承 构建 逻辑 ， 并 且 也 设置 5 为 $44(WORKDIR}， 因 为 获取 器 直接 复制 源 文件 到 那里 。 


对 菜谱 来 涡 ， 那 就 是 全 部 了 ， 因 为 复制 在 程序 清单 9-14 中 的 makefile 遵 守 module 类 的 构建 目标 和 参数 惯例 。 


程序 清单 9-14 模块 makefile (Makefile) 


obj-m := hello.o 
SRC := $(shell pwd) 


all: 
$ (MAKE) -C $(KERNEL SRC) M=$(SRC) 


modules _install: 
$ (MAKE) -C $(KERNEL SRC) M=S$ (SRC) modules install 


clean: 
rm -f *.o *~ core .depend .*.cmd *.ko *.mod.c 
rm -f Module.markers Module.symvers modules.order 
rm -rf .tmp_versions Modules.symvers 


这 是 一 个 简单 而 典型 的 Linux 内 核 模块 makefile。 模 块 类 要 求 一 个 默认 目标 (all) 和 一 个 名 为 modules install 的 安装 目标 。 内 核 模 块 必须 从 内 核 源 
树 内 构建 。 因 此 变量 KERNEL SRC 和 -C 人 参数 一 起 被 传递 。 模 块 类 设置 KERNEL SRC 为 STAGING KERNEL DIR， 它 包含 构建 系统 保存 内 核 源 的 位 置 。 参 


数 MI 告诉 构建 系统 ， 树 外 内 核 模块 正在 被 构建 。M 必 须 被 设置 成 模块 的 源 目录 。 


程序 清单 9-15 模块 类 (poky/meta/classes/module.bbclass) 


DEPENDS += "virtual/kernel" 
inherit module-base kernel-module-split 


addtask make_scripts after do_patch before do_compile 
do_make_scripts[lockfiles] = "${TMPDIR}/kernel-scripts.lock" 
do_make_scripts[deptask] = "do_populate_sysroot" 


module_do_compile() { 

unset CFLAGS CPPFLAGS CXXFLAGS LDFLAGS 

oe runmake KERNEL PATH=S${STAGING KERNEL DIR} 
KERNEL SRC=$ {STAGING KERNEL DIR} 
KERNEL_VERSION=S$ {KERNEL _VERSION} 
CC="$ {KERNEL CC}" LD="$ {KERNEL_LD}" 
AR="S{KERNEL AR}" \ 
$ {MAKE TARGETS} 


E gh ag ee 


} 


module do _install() { 
unset CFLAGS CPPFLAGS CXXFLAGS LDFLAGS 
oe runmake DEPMOD=echo INSTALL MOD PATH="S${D}" \ 
KERNEL SRC=$ {STAGING KERNEL DIR} \ 
CC="$ {KERNEL CC}" LD="${KERNEL_LD}" \ 
modules install 


} 

EXPORT_FUNCTIONS do_compile do_install 

# add all splitted modules to PN RDEPENDS, PN can be empty now 
KERNEL MODULES META PACKAGE = "S{PN}" 


FILES _S${PN} = "" 
ALLOW_EMPTY_S${PN} = "1" 


我 们 复制 模块 类 在 程序 清单 9-15 中 ， 因 为 理解 类 在 编写 内 核 模 块 及 其 菜谱 时 有 帮助 。 
类 设置 vittual/Ketnel 作 为 构建 依赖 ， 这 保证 在 构建 系统 尝试 构建 模块 之 前 内 核 已 经 被 构建 了 。 


- 它 继承 自 module-base，module-base 定 义 了 make_sctipts 任 务 以 在 构建 模块 之 前 构建 内 核 脚 本 。 它 在 patch 任 务 之 后 compile 任 务 之 前 增加 那个 任务 。 
Linux 内 核 树 包含 一 些 为 主机 系统 构建 的 工具 。 一 些 模块 需要 那些 工具 。 然 而 ，STAGING KERNEL DIR 不 包含 这 些 工具 的 二 进 制 版 本 。 构 建 系统 在 为 目 
标 打包 内 核 源 之 前 从 STAGING_KERNERI, DIR 中 去 除了 这 些 二 进 制 。 理 由 是 ， 为 主机 系统 构建 的 工具 不 适用 于 目标 ， 当 然 ， 这 意味 着 ， 在 内 核 已 经 被 打 
包 好 后 ， 为 了 构建 模块 ， 工 具 必须 被 再 次 构建 。 


- kernel-module-split 类 处 理 内 核 模块 的 打包 。 主 要 包 被 前 级 以 kernel-module-。 对 于 我 们 的 hello-mod 例 子 ，kernel-module-hello-mod 包 包含 实际 内 核 模块 


二 进 制 。 


- 在 module_do_compile 任 务 中 ， 除 了 KERNEL SRC， 类 也 传递 KERNEL_PATH 到 makefile。 传 递 这 两 个 参数 为 最 常用 在 模块 makefile 中 的 内 核 源 目 录 
处 理 这 两 个 变量 名 。 类 也 为 来 自 变 量 KERNEL_CC、KERNEIL LD 和 KERNEI， AR 的 编译 器 (CC) 、 链 接 器 (LD) 和 打包 器 (AR) 传递 命令 ， 这 当然 包 


括 用 于 目标 架构 的 正确 的 交叉 工具 栏 版 本 。 


- 在 运行 nodule_do_install 任 务 时 ， 类 传递 DEPMOD=echo 到 makefile。 因 为 几乎 所 有 模块 都 设计 成 构建 和 安装 在 主机 系统 上 ， 人 安装 目标 通常 调用 
depmod 实 用 程序 来 创建 符号 图 (symbol map) 。 当 然 ， 当 在 一 个 主机 系统 上 为 另 一 个 目标 系统 构建 模块 时 ， 那 是 不 合适 的 。 因 此 ，depmod 被 蔡 换 成 
echo， 它 仅仅 产生 日 志 输 出 。 


当 使 用 Yocto 项 目 来 构建 第 三 方 模块 时 ， 你 可 能 必须 覆盖 module do_compile 或 module_do install 任 务 以 匹配 参数 。 


[1] 在昌 内 核 模 块 的 makefile 中 ， 你 也 可 能 找到 变量 SUBDIRS， 它 是 为 了 向 后 兼容 而 保留 的 。 


94.2 ”创建 用 于 第 三 万 模块 的 采 增 


通常 ， 树 外 模块 是 和 用 于 原生 地 构建 模块 的 makefile 一 起 交付 的 ， 也 就 是 ， 为 构建 系统 原生 地 构建 模块 。 看 一 下 makefile， 它 可 以 告诉 你 是 否 需 要 


调整 以 及 如 何 调 整 菜谱 来 构建 内 核 模块 。 这 里 是 一 些 要 注意 的 项 目 : 


: 内 核 源 目录 : 为 了 使 过 程 对 用 户 来 说 是 简化 的 ， 模 块 开 发 者 通常 把 逻辑 构建 到 makefile 中 以 自动 化 地 检测 内 核 源 的 位 置 。 当 为 主机 系统 构建 时 ， 其 
工作 得 很 好 ; 但 是 对 于 Yocto 项 目 构 建 ， 这 不 好 使 。 因 此 ， 你 需要 寻找 用 于 内 核 源 目录 的 变量 ， 例 如 多 SRC、KERNEIL PATH 或 者 KERNEIL SRC， 并 且 最 


终 在 你 的 菜谱 中 赋值 它 。 


. 构建 目标 : 大 部 分 内 核 模 块 makefile 定 义 编译 模块 的 默认 构建 目标 。 如 果 没 有 目标 被 显 式 地 传递 到 makefile， 那 么 这 个 目标 被 调用 ， 这 是 用 于 
module_do_compile 任 务 的 默认 值 。 对 大 部 分 情况 ， 其 工作 得 很 好 。 


- See Ain: module 类 期 望 安装 目标 为 modules_install， 它 是 内 核 开 发 管理 。 然 而 ， 很 多 模块 仅仅 使 用 install。 
. 子 目录 结构 : 如 果 makefile 不 在 模块 源 包 的 顶级 目录 中 而 是 在 一 个 包含 源 的 子 目 录 中 ， 那 么 你 必须 对 应 地 调整 S 变 量 。 


许可 文件 : 构建 系统 期 望 许可 文件 位 于 模块 源 包 的 顶级 目录 中 。 如 果 不 是 这 种 情况 ， 那 么 你 的 菜谱 必须 把 它 复制 到 那里 。 向 你 的 菜谱 增加 一 个 


do_configure_prepend 用 于 复制 许可 文件 。 
程序 清单 9-16 作 为 一 个 例子 ， 显 示 了 为 Intel PCI-E 40 干 兆 网 络 连 接 中 构建 Linux 驱 动 的 菜谱 。 
程序 清单 9-16 ”用 于 Intel PCI-E 40 Linux 驱 动 的 菜谱 
SUMMARY = "Base Driver for the Intel(R) XL710 Ethernet Controller Family" 


LICENSE = "GPLv2" 
LIC_FILES_CHKSUM = "file://COPYING;md5=d181af11d575d88127d52226700b0888" 


inherit module 

PR = "pg" 

# Point SRC_URI to SDK tarball 

SRC URE = "files //s{TOPDLR) /.»/1d0eL. 2 416. tar.gz" 


do_configure_prepend() { 
# license file is expected to be in ${S$} 
cp ${WORKDIR}/${P}/COPYING ${S} 

} 


module_do_compile() { 

unset CFLAGS CPPFLAGS CXXFLAGS LDFLAGS 

oe_runmake KSRC=${STAGING_KERNEL_DIR} 和 
BUILD KERNEL=$ {KERNEL VERSION} \ 
KVER=S {KERNEL VERSION} \ 

INSTALL_MOD_PATH="${D}" \ 

CC="${KERNEL_CC}" LD="S${KERNEL_LD}" \ 
AR="S{KERNEL AR}" \ 
S{MAKE TARGETS} 


} 


module do_install() { 

unset CFLAGS CPPFLAGS CXXFLAGS LDFLAGS 

oe runmake DEPMOD=echo INSTALL MOD PATH="S${D}" \ 
BUILD KERNEL=$ {KERNEL VERSION} \ 
KSRC=${STAGING KERNEL DIR} \ 
KVER=$ {KERNEL VERSION} \ 
CG="S (KERNEL CC?" LD="STRERNEL: LD)" \ 
install 


} 


S = "S{WORKDIR}/S{P}/src" 


对 很 多 模块 ， 你 可 以 在 你 的 菜谱 中 调整 来 自 module 类 的 默认 值 以 构建 模块 。 这 是 更 受 欢 迎 的 方法 ， 因 为 你 不 必 为 模块 源 代 码 打 补丁 。 然 而 ， 可 能 
一 些 模块 ， 你 必须 对 它们 提供 补丁 才能 够 构建 模块 。 对 这 样 的 模块 ， 以 菜谱 内 空间 的 方式 提供 补丁 并 且 增 加 它们 到 SRC_URI。 


[1] T vA https: //downloadcenter.intel.com/download/24411 /Network-Adaptert-Driver-for-PCI-E-40-Gigabit-Network-Connections-under-Linux-4 3] JF] F 5k a 89 


源 包 。 


94.3 ”把 模块 包含 在 根 文件 系统 中 


最 后 步骤 是 ， 在 用 于 目标 的 根 文件 系统 镜像 中 包含 模块 。 绝 大 部 分 模块 是 用 于 硬件 驱动 的 ， 这 当然 意味 着 ， 只 有 在 目标 硬件 相应 地 配备 了 相关 硬件 
的 情况 下 ， 把 模块 包含 进 根 文件 系统 才 是 有 价值 的 。 为 了 这 个 目的 ， 构 建 系统 提供 了 如 下 的 变量 ， 它 们 通常 是 被 设置 在 机 器 配置 文件 中 的 [1]: 


MACHINE ESSENTIAL EXTRA RDEPENDS: 镜像 构建 所 需 的 机 器 特定 包 列 表 。 在 构建 系统 可 以 创建 镜像 之 前 ， 任 何 你 增加 到 这 个 变量 的 模块 包 
都 必须 被 构建 。 因 为 它 是 机 器 必要 的 变量 ， 所 以 在 列表 中 的 包 都 被 认为 是 机 器 启动 的 关键 。 变 量 由 所 有 基于 packagegroup-cote-boot 的 镜像 来 评估 。 


- MACHINE_ESSENTIAL_ EXTRA RRECOMMENDS: 为 机 器 推荐 的 机 器 特定 包 列 表 ， 与 前 一 个 变量 相似 ， 但 是 构建 过 程 不 依赖 于 它们 。 这 意味 
着 ， 即 使 这 个 列表 中 的 包 不 存在 ， 镜 像 依然 能 成 功 构 建 。 这 个 列表 中 的 包 是 机 器 必要 的 ， 意 味 着 它们 是 机 器 启动 所 需要 的 。 这 听 起 来 矛盾 ， 但 是 对 于 可 
能 被 编译 进 Linux 内 核 而 不 是 作为 模块 包 来 提供 的 模块 来 说 是 有 意义 的 。 


- MACHINE EXTRA RDEPENDS: 镜像 构建 所 需要 的 机 器 特定 包 列 表 。 然 而 ， 相 较 于 MACHINE_ESSENTIAL_EXTRA_RDEPENDS， 这 些 包 对 于 
机 器 启动 来 说 不 是 必要 的 。 这 个 变量 由 所 有 基于 packagegroup-base 的 镜像 来 评估 。 


- MACHINE_EXTRA_RRECOMMENDS: 为 机 器 推荐 的 但 对 启动 机 器 不 是 必要 的 机 器 特定 包 列 表 。 


例如 ， 增 加 
MACHINE EXTRA RDEPENDS += "kernel-module-<module name>" 


到 你 的 机 器 定义 文件 以 在 你 的 镜像 中 包含 内 核 模块 。 


你 可 能 有 疑问 ， 是 否 可 以 增加 模块 到 镜像 菜谱 中 的 IMAGE INSTALL 变 量 。 当 然 ， 那 是 可 能 的 ， 但 是 如 果 模 块 不 依赖 于 机 器 特定 的 硬件 特性 的 话 ， 那 
么 那样 做 是 不 被 推荐 的 。 


[1] 在 下 一 章 我 们 讨论 Yocto 项 目 板 支持 包 时 ， 我 们 将 讨论 机 器 配置 。 


944 模块 目 动 加 载 
构建 系统 可 以 使 用 你 目标 系统 上 的 /etc/modules-load.d 和 /etc/modprobe.d 来 配置 自动 但 静态 的 模块 加 载 。 尽 管 依赖 于 由 硬件 识别 和 类 似 触发 器 
基础 上 的 udev 提 供 的 自动 模块 加 载 通常 是 一 个 比较 好 的 主意 ， 但 是 ， 可 能 在 一 些 用例 中 ， 启 动 时 的 静态 模块 加 载 是 有 意义 的 。 


当 使 用 systemd 和 systemd-modules-load.service 时 ， 变 量 KERNEL MODULE AUTOLOAD 指 定 在 启动 时 需要 被 加 载 的 模块 的 列表 : 
KERNEL MODULE AUTOLOAD += "modulel module2 module3" 


对 每 个 列 出 的 模块 ， 构 建 系统 在 in/etc/modules-load.d 中 创建 一 个 以 模块 名 字 命 名 的 、 以 .conf 结 尾 的 、 内 容 包 含 要 加 载 的 模块 名 字 的 文件 。 文 件 
的 词典 编撰 的 顺序 决定 模块 的 加 载 顺 序 。 


为 了 通过 /etc/modprobe.d 来 为 模块 提供 配置 参数 ， 你 使 用 变量 KERNEL MODULE PROBECONF 和 module conf <module name>。 和 
KERNEL MODULE AUTOLOAD 类 似 ，KERNEL MODULE PROBECONF 仅 仅 是 模块 名 字 的 列表 。 对 于 在 KERNEL MODULE PROBECONF 中 的 每 个 
项 ， 构 建 系统 要 求 一 个 module_conf <module name> 变 量 ， 它 指定 如 modprobe 所 需要 的 模块 配置 。 例 如 ， 对 虚构 的 名 为 foofighter 且 需要 两 个 配置 
变量 的 模块 ， 使 用 


KERNEL_MODULE_PROBECONF += "foofighter'" 
Module_conf_foofighter = "options foofighter foo=1 bar=2" 


你 通常 在 用 于 你 模块 的 菜谱 中 放置 这 些 设 置 。 


9.5 ”设备 树 


简单 来 说 ， 设 备 树 是 描述 硬件 平台 的 数据 结构 。 与 将 设备 及 其 配置 的 每 个 细节 硬 编码 到 内 核 源 中 不 同 ， 在 启动 时 ， 一 个 数据 结构 被 传递 到 内 核 。 这 
些 细节 包括 |/O 地 址 、 内 存 地 址 空间 、 中 断 等 。 设 备 树 编译 器 (Device Tree Compiler, DTC) 把 设备 树 从 其 人 类 可 读 的 层级 格式 编译 成 通常 被 称 为 扁平 
设备 树 (Flattened Device Tree，FTD) 的 二 进 制 格式 。 


1 


OpenEmbedded 构 建 系 统 支持 使 用 设备 树 编译 器 从 设备 树 源 文件 构建 扁平 设备 树 。 设 备 树 源 文件 以 .dts 结 尾 。 包 含 FTB 的 文件 以 .dtb 结 尾 。 在 本 节 
中 ， 我 们 解释 如 何 用 构建 系统 为 给 定 的 平台 或 者 机 器 构建 设备 树 [站 。 


设备 树 是 平台 或 者 机 器 特定 的 ， 因 为 它们 描述 平台 的 硬件 配置 。 它 们 是 作为 内 核 菜 谱 的 一 部 分 而 被 构建 的 。 为 使 其 工作 ， 内 核 菜 谱 必 须 包 合 : 


require recipes-kernel/linux/linux-dtb.inc 
或 者 : 


require recipes-kernel/linux/linux-yocto.inc 


现在 你 必须 通过 设置 变量 KERNEL_DEVICETREE 为 用 于 你 平台 的 扁平 设备 树 的 名 字 ， 以 告诉 构建 系统 为 你 的 平台 构建 什么 设备 树 。 例 如 ， 
KERNEL DEVICETREE = "am335x-bone.dtb am335x-boneblack.dtb" 


命令 构建 系统 为 BeagleBone (White) 和 BeagleBoneBlack 生 成 局 平 设备 树 文件 。 这 个 变量 的 最 佳 位 置 是 机 器 配置 文件 ， 其 包含 所 有 机 器 特定 的 设 
置 。 


[1] 如 果 你 正在 寻找 关于 设备 树 是 如 何 被 结构 化 的 以 及 如 何 为 你 的 平台 开发 设备 树 的 信息 ， 那 么 参考 www.devicettee.otfg 和 http://elinux.otg/Device_ Tree。 


9.6 Rae 


IONA 


在 本 章 中 ， 我 们 聚焦 在 用 Yocto 项 目 构建 Linux 内 核 和 内 核 模块 上 。 

-使 用 菜单 编辑 器 和 配置 片段 ， 构 建 系统 提供 了 允许 快速 往返 测试 和 内 核 配 置 集成 的 工具 化 。 

: 用 于 内 核 源 代码 的 补丁 的 应 用 方式 ， 和 对 任何 其 他 软件 包 应 用 补丁 的 方式 完全 相同 。 

在 最 简单 的 形式 下 ，Linux 内 核 可 以 通过 提供 菜谱 内 空间 或 者 入 树 配置 来 直接 从 来 自 源 tar 包 或 Git 仓 库 的 内 核 树 源 中 构建 。 


- Yocto 项 目 维护 它 自己 的 Linux 内 核 基 础 设施 ，Linux 基 础 设施 由 包含 内 核 源 以 及 配置 元 数据 和 补丁 的 仓库 组 成 。Yocto 项 目 内 核 工 具 化 允许 使 用 元 数 


据 特 性 进行 灵活 的 配置 。 
.Yocto 内 核 基 础 设施 为 3 个 基础 配置 〈 标 准 、 实 时 和 小 型 ) 提供 了 维护 的 内 核 源 ， 用 于 板 支持 包 的 特定 分 支 是 从 这 3 个 基础 配置 中 衍生 出 来 的 。 
- Yocto 项 目 采 用 在 多 年 内 提供 持续 支持 的 长 期 支持 计划 (LSTI) 内 核 ， 这 对 内 入 式 项 目 来 说 尤其 有 益 。 


` 通过 module 类 ， 构 建 系统 支持 树 外 内 核 模 块 的 便利 构建 。 


9.7 参考 文献 


Linux Atz, Documentation/kbuild/kbuild.txt, 


Yoctoln H LinuxNRARFH, www.yoctoproject.org/docs/1.8/kernel-dev/kernel-dev.html, 


P10 hide 


前 面 的 章节 为 使 用 Yocto 项 目 工具 构建 定制 Linux 系 统 铺垫 了 基础 。 我 们 使 用 软件 系统 模拟 器 QEMU 来 测试 。 在 本 章 中 ， 我 们 更 进一步 地 探讨 并 且 还 
示例 了 构建 系统 如 何 支 持 创建 用 于 实际 硬件 的 Linux 内 核 和 根 文件 系统 。 


硬件 支持 是 由 板 支 持 包 (Board Support Package, BSP) 提供 的 。 如 果 你 熟悉 嵌入 式 系 统 文档 ， 那 么 你 很 可 能 之 前 已 经 听 说 过 术语 板 支 持 包 。 然 
而 ,尽管 有 相同 的 名 字 ， 但 是 Yocto 项 目 板 支 持 包 与 用 于 典型 窜 入 式 系 统 的 更 传统 的 板 支 持 包 是 相当 不 同 的 。 


本 草 首先 解释 Yocto 项 目 板 支 持 包 背后 的 理念 以 及 为 什么 Yocto 项 目 板 支持 包 不 同 于 传统 板 支 持 包 。 然 后 ， 我 们 使 用 板 支 持 包 来 为 一 个 嵌入 式 .评估 板 
构建 系统 ， 把 那个 系统 放 在 那个 板 上 ， 最 后 启动 板 。 在 本 草 的 结尾 ,我 们 概述 了 如 何 为 自己 的 硬件 创建 Yocto 项 目 板 支持 包 。 


10.1 Yocto 项 目 板 支 持 包 理 念 


忌 体 来 说 ， 板 支持 包 是 用 于 给 定 硬件 (例如 嵌入 式 设备 板 ) 的 给 定 操作 系统 的 特定 调整 。 板 支持 包 通 常 是 由 半导体 和 板 厂 商 提 供给 他 们 的 客户 的， 
以 便 客 户 在 广 商 的 硬件 上 构建 、 加 载 和 运行 操作 系统 。 


传统 板 支 持 包 通常 由 下 面 这 些 术语 组 成 : 


文档 : 我 们 把 文档 放 在 首位 ， 因 为 任何 板 支持 包 都 应 该 包含 文档 。 文 档 描 述 板 支持 包 的 内 容 ， 提 供 关 于 板 支 持 包 支持 的 特定 硬件 的 信息 ， 包 含 关 
于 如 何 使 用 板 支持 包 为 硬件 构建 操作 系统 、 把 操作 系统 镜像 传输 到 硬件 以 及 居 动 硬件 的 使 用 说 明 。 另 外 ， 文 档 可 能 包含 如 何 调 整 板 支持 包 以 用 于 类 似 板 
支持 包 支 持 的 参考 硬件 的 硬件 的 信息 。 


‘HALA: 通常 ， 厂 商 包 含 至 少 一 个 带 有 编译 器 、 汇 编程 序 、 链 接 器 和 打包 器 的 工具 链 。 工 具 链 匹配 被 支持 的 硬件 和 源 代码 。 一 些 板 支持 包 甚至 
可 能 包含 软件 开发 工具 包 以 及 最 终 的 集成 开发 环境 ， 例 如 Eclipse， 这 使 得 对 目标 硬件 的 开发 更 加 便利 。 


操作 系统 源 代码 和 二 进 制 : 如 果 操作 系统 是 开源 的 ， 那 么 一 些 板 支持 包 甚 至 会 包含 用 于 操作 系统 的 完整 源 代 码 。 如 果 操作 系统 是 专 有 的 ， 那 么 仅 
仅 对 编译 设备 驱动 和 应 用 软件 来 说 必要 的 源 代 码 〈 例 如 头 文件 和 静态 连接 的 库 ) 才 可 能 被 包含 。 所 有 其 他 操作 系统 文件 是 以 二 进 制 形式 提供 的 。 因 为 操 
作 系 统 源 和 二 进 制 可 能 是 巨大 的 ， 所 以 常见 的 是 ， 在 构建 时 ， 所 提供 的 开发 工具 使 用 厂商 的 仓库 和 下 载 站 点 来 按 需 获取 源 代码 和 二 进 制 。 


- 源 代码 补丁 : 如 果 板 支持 包 针 对 的 硬件 需要 特殊 的 设备 驱动 、 配 置 或 者 位 于 基础 操作 系统 软件 包 之 上 的 其 他 模块 ， 那 么 板 支 持 包 可 能 提供 它们 。 
替代 性 地 ， 常 见 的 是 ， 厂 商 已 经 为 操作 系统 源 打 了 补丁 ， 以 至 板 支持 包 不 需要 包含 任何 补丁 。 


. 文件 系统 镜像 : 板 支持 包 也 可 能 包含 用 于 被 支持 的 硬件 的 完整 文件 系统 镜像 ， 这 非常 方便 ， 因 为 它 有 助 于 调 出 目标 ， 并 且 在 构建 你 自己 的 系统 时 
提供 参考 。 


包含 从 文档 到 文件 系统 镜像 的 一 切 的 板 支 持 包 非常 有 利于 用 户 快 速 上 手 ， 因 为 大 部 分 的 依赖 性 是 由 包含 在 板 支 持 包 中 的 东西 解决 的 。 然 而 ， 长 期 维 
护 有 时 候 会 成 为 挑战 ， 特 别 是 在 厂商 没有 提供 定期 更 新 的 情况 下 。 我 们 依然 可 以 看 到 很 多 用 于 片上 系统 和 使 用 Linux 内 核 版 本 2.6 的 开发 板 的 厂商 板 支 持 
包 。 


如 果 骨 入 式 项 目 希 望 利用 那些 片上 系统 和 仪 仅 被 更 新 的 内 核 版 本 支持 的 其 他 硬件 ， 那 么 这 束 成 了 问题 。 如 果 刻 上 系统 厂商 不 为 板 支 持 包 提 供用 于 后 
来 的 Linux 内 核 的 更 新 ， 那 么 作为 系统 管理 员 的 你 将 面 对 这 样 一 个 任务 : 移植 板 支 持 包 到 更 新 的 内 核 版 本 ， 或 者 向 后 移植 设备 支持 到 由 板 支 持 包 支 持 的 更 
旧 的 内 核 版 本 中 。 这 两 种 方法 都 有 潜在 的 陷阱。 


移植 板 支 持 包 到 后 来 的 Linux 内 核 版 本 对 于 具有 未 知 历史 的 板 支 持 包 来 说 可 能 变 得 非常 困难 : 厂商 什么 时 候 分 支 了 上 游 源 ? 应 用 过 什么 修改 ? 


另 一 方面 ， 如 果 设 备 驱动 依赖 的 特性 仅仅 在 最 新 Linux 内 核 中 可 用 ， 那 么 向 后 移植 设备 驱动 也 许 是 不 可 能 的 。 

Yocto 项 目 为 板 支 持 包 采用 了 不 同 的 方法 : 

- Yocto 项 目 板 支持 包 不 是 独立 的 ， 这 一 点 不 像 传统 板 支 持 包 。 它 们 依赖 于 例如 Open-Embedded 核 心 (meta) 以 及 可 能 其 他 层 的 基础 元 数据 层 。 
Yocto 项 目 板 支持 包 不 包含 构建 系统 或 者 任何 开发 工具 。 它 们 是 由 Yocto 项 目 本 身 提供 ， 并 在 构建 过 程 中 被 创建 。 

` 除了 菜谱 和 最 终 的 补丁 ，Yocto 项 目 板 支持 包 不 包含 任何 源 代码 。 

* Yocto 项 目 板 支持 包 仅 仅 关 心 特定 于 特殊 硬件 的 组 件 。 


本 质 上 ，Yocto 只 不 过 是 为 了 支持 目标 硬件 而 包含 对 核心 层 的 增加 和 修改 的 特殊 元 数据 层 。 所 有 Yocto 项 目 板 支 持 包 都 圣 少 依赖 OpenEmbedded 核 
心 元 数据 层 。 


Yocto 项 目 板 支 持 包 把 板 支 持 包 的 维护 限定 为 其 增加 的 包 和 用 于 它 所 修改 的 底层 的 层 。 所 有 其 他 维护 工作 是 底层 的 责任 。 当 然 ， 这 种 方法 意味 着 
Yocto 项 目 板 支 持 包 的 一 个 特定 版 本 是 和 它 所 依赖 的 底层 的 特定 版 本 绑 定 的 。 如 果 底 层 变 化 一 一 例如 ， 如 果 元 数据 层 不 再 支持 一 个 特定 内 核 版 本 一 一 那 
么 板 支 持 包 必 须 被 调整 。 然 而 ， 这 种 维护 工作 通常 远 远 少 于 维护 传统 板 支 持 包 。 


Yocto 项 目 板 支 持 包 的 维护 工作 被 Poky 构 建 系统 的 依赖 性 处 理 进 一 步 缩减 。 大 部 分 包 并 不 依赖 于 特定 目标 硬件 。 由 条 件 变量 履 盖 提供 的 依赖 性 处 理 
保证 ， 构 建 依 赖 于 硬件 的 包 (例如 Linux 内 核 ) 的 菜谱 会 获得 关于 目标 硬件 以 及 架构 的 正确 信息 。 


板 支 持 包 依赖 性 处 理 


构建 系统 的 板 支持 包 依赖 性 处 理 不 但 减轻 了 维护 工作 而 且 也 使 得 板 支持 包 可 以 很 容易 地 互相 交换 ， 简 直 就 是 在 配置 文件 中 修改 一 行 代码 的 事 。 对 于 
像 你 一 样 的 系统 构建 者 来 说 ， 这 是 巨大 的 收益 。 它 使 得 你 能 够 在 今天 为 一 个 板 构 建 完全 相同 的 根 文件 系统 ， 并 且 在 下 一 天 为 男 一 个 甚至 可 能 使 用 具有 完 
全 不 同 架构 的 片上 系统 的 板 构建 完全 相同 的 根 文件 系统 。 我 们 把 这 个 特性 叫 作 Yocto 项 目 板 支持 包 的 正 交 性 (orthogonality) ， 虽 然 术语 从 数学 角度 的 
正 交 性 [来 看 并 不 完全 正确 ， 但 是 用 户 可 以 为 下 一 次 交换 一 个 板 支持 包 而 不 用 担心 变更 构建 系统 的 其 他 部 分 。 


快速 地 看 一 下 构建 系统 如 何 处 理 目标 特定 的 依赖 性 是 值得 的 ， 因 为 它们 常见 于 依赖 硬件 配置 的 菜谱 中 。 
在 第 4 章 的 4.4.2 小 节 ， 讨 论 了 使 用 变量 OVERRIDES 实 现 的 BitBake 条 件 变 量 赋值 机 制 。 这 种 机 制 是 构建 系统 用 于 板 文 持 包 的 依赖 性 处 理 的 基础 。 变 


量 OVERRIDES 包 含 逗号 分 隔 的 覆盖 条 件 列表 ， 从 左 到 右 ， 覆 盖 条 件 的 优先 级 递增 。 Poky 参 考 发 行 版 设置 变量 为 如 下 表达 式 四 : 


OVERRIDES="$ {TARGET 0S}:S{TRANSLATED TARGET ARCH}:build-S{BUILD 0S}: \ 
pn-${PN}:${MACHINEOVERRIDES}:$ {DISTROOVERRIDES} : \ 
$ {CLASSOVERRIDE}: forcevariable" 


对 特定 目标 ， 对 应 地 扩展 表达 了 式 内 的 变量 。 例 如 ， 对 于 64 位 x86 Qemu 目 标 ， 


OVERRIDES="linux:x86-64:build-linux:pn-core-image-minimal: \ 
gemuall:qemux86-64:poky:class-target: forcevariable:libc-glibc" 


板 支 持 包 特定 的 设置 是 由 变量 MACHINEOVERRIDES 提 供 的 ， 对 这 个 例子 来 说 ， 它 扩展 成 qemuall: qemux86-64, 


本 质 上 ， 有 两 个 设置 : qemuallfhqemux86-64。 前 者 提供 用 于 QEMU 机 器 的 履 芋 ， 而 后 者 特别 为 64 位 x86 模 拟 提 供 宪 盖 。 后 者 有 更 高 优先 级 ， 因 为 
它 是 列 在 前 者 之 后 的 。 如 果 特 定 变 量 需要 机 器 依赖 设置 ， 那 么 这 仅仅 是 把 机 器 覆 匡 追加 到 变量 去 了 。 例 如 ， 


KERNEL FEATURES_ append qemux86-64=" cfg/sound.scc" 


如 果 目 标 构 建 是 针对 qemux86-64， 那 么 它 增 加 配置 描述 到 KERNEL FEATURES, 
像 前 面 那个 ， 板 支持 包 频 繁 地 在 菜谱 和 追加 文件 中 使 用 条 件 变 量 赋值 来 为 特定 目标 微调 菜谱 。 
对 本 章 的 后 续 部 分 来 说 ， 除 非 我 们 另 有 显 式 声明 ， 否 则 我 们 将 把 Yocto 项 目 板 支 持 包 等 称 为 板 支持 包 ， 以 使 得 文本 更 加 清晰 。 


[1] 数学 上 的 正 交 性 意味 着 两 个 维度 是 完全 互 不 依赖 的 。 当 然 ， 对 于 构建 系统 来 说 ， 那 是 不 正确 的 ， 因 为 由 板 支持 包 提供 的 目标 依赖 变量 设置 覆盖 构建 系 


统 的 标准 设置 。 从 用 户 视角 来 看 ， 不 考虑 板 支持 包 的 细节 ， 板 支持 包 和 构建 系统 看 起 来 是 相互 独立 的 。 
[2] 你 可 以 通过 在 构建 环境 中 执行 bitbake-e core-image-minimal | grep OVERRIDES 来 获得 这 个 信息 。 


10.2 ”用 板 文 持 包 构 建 


板 支 持 包 仪 仪 是 一 个 元 数据 层 ， 它 包含 一 个 配置 文件 形式 的 机 器 定义 ， 其 中 机 器 的 名 称 以 .conf 结 尾 。 机 器 配置 文件 位 于 板 支 持 包 层 的 
conf/machine 子 目录 内 。 为 了 使 用 板 支 持 包 ， 你 需要 增加 它 到 构建 环境 conf/bblayers.conf 文 件 中 的 BBLAYERS 变 量 。 然 后 ， 必 须 设置 构建 环境 
conf/local.conf 文 件 内 的 MACHINE 变 量 为 你 希望 为 其 构建 的 机 器 的 名 字 。 


技术 上 ， 贯 穿 前 面 的 草 节 ,， 我 们 一 直 在 隐 式 地 将 板 支 持 包 用 于 qemux86 构 建 。 你 可 以 在 位 于 poky/meta/conf/machine/qemux86.conf 的 构建 环 
境 的 OpenEmbedded 核 心 元 数据 层 中 找到 用 于 qemux86 的 机 器 定义 。OpenEmbedded 核 心 元 数据 层 为 不 同 架 构 的 各 种 模拟 机 器 提供 机 器 定义 : 
qemuarm、qemuarm64、qemumips、qemumips64、qemuppc、qemux86 和 qemux86-64。 提 供 机 器 定义 本 质 上 使 该 层 成 为 板 支 持 包 层 。 


Yocto 项 目 也 包含 用 于 实际 硬件 机 器 的 自 有 板 支 持 包 层 : meta-yocto-bsp。 这 个 层 默 认 包含 在 每 个 由 oe-init-build-env 创 建 的 构建 环境 的 


BBLAYERS 中 。 它 提供 用 于 Texas Instruments BeagleBonellj 板 、Ubiquity Networks EdgeRouter!@!, Freescale MPC8351E-RDB 参 考 平台 BJ 和 通用 
32 位 以 及 64 位 x86 平 台 的 机 器 定义 。 


为 任何 这 些 目标 平台 进行 构建 都 是 简单 的 。 文 件 conf/local.conf 已 经 包含 用 于 目标 平台 的 MACHINE 设 置 。 你 仅仅 需要 取消 注释 你 希望 为 其 构建 的 


目标 平台 。 


当然 ， 这 是 一 个 非常 有 限 的 硬件 平台 列表 。Yocto 项 目 包含 它们 是 为 了 便利 性 和 测试 目的 。 有 好 多 其 他 来 自 片上 系统 厂商 、 板 厂商 和 社区 的 用 于 大 量 
不 同 硬件 的 板 支 持 包 可 用 。 在 10.2.2 小 节 ， 我 们 将 深入 探讨 如 何 查 找 和 利用 外 部 板 支 持 包 的 细节 。 


[1] http://beagleboard.org/bone o 
[2] https://www.ubnt.com/edgemax/edgerouter. 


[3] http://www.nxp.com/files/32bit/doc/fact_sheet/MPC8315ERDBFS.pdf. 


10.2.1 为 BeagleBone 构 建 


BeagleBone 是 基于 Texas Instruments AM335x ARM Cortex-A8 片 上 系统 的 开发 板 。 硬 件 和 软件 是 开放 设计 ， 它 是 由 BeagleBoard.org 基 金 会 创 
建 和 支持 的 []， 该 基金 会 是 设 在 美国 的 非 盈利 组 织 ， 它 的 目标 是 “提供 嵌入 式 计 算 中 开源 软件 、 硬 件 的 设计 和 使 用 的 教育 并 推广 之 ”。 

BeagleBone 有 多 个 变 体 : 原始 的 BeagleBone (White) 、BeagleBone Black 以 及 现在 的 BeagleBone Green。 根 据 各 自 印 制 电 路 板 (Printed 
Circuit Board, PCB) 的 颜色 ， 它 们 容易 被 区 分 。BeagleBone Black 使 用 具有 1GHz 时 钟 速度 的 更 强劲 版 本 的 AM3358 片 上 系统 ， 提 供 512MB 内 存 (是 
原始 BeagleBone 内 存 的 2 倍 ) ， 并 且 提 供 2GB (在 修订 C 型 号 中 是 4GB) 板 载 谨 入 式 多 媒体 (embedded MultiMedia Card, eMMC) 存储 。 而 
H, BeagleBone Black 仅 仅 花 费 稍微 比 原始 板 一 半 多 一 点 的 成 本 。 然 而 ，Black 版 没有 配备 用 于 系统 控制 台 的 USB 到 串 行 的 转换 器 。 当 运行 Yocto 项 目 构 
建 时 ， 串 行 系统 控制 台 对 于 与 系统 交互 是 必要 的 ， 因 为 板 没有 显示 器 后 。BeagleBone Green 是 基于 BeagleBone Black 的 ， 但 是 去 除了 板 载 高 清 多 媒体 
接口 (High-Definition Multimedia Interface, HDMI) 连接 器 ， 以 便 为 两 个 承载 12C 信 和 号 的 连接 器 创造 空间 来 与 由 Seeed StudiosB 提 供 的 Grove 传 感 
器 简单 地 对 接 。 


构建 BeagleBone 镜 像 


为 了 用 OpenEmbedded 构 建 系统 构建 用 于 BeagleBone 的 Linux 系 统 ， 在 构建 环境 的 conf/local.conf 中 人 简单 地 取消 以 下 注释 (以 及 最 终 注释 掉 前 面 
你 曾经 使 用 过 的 所 有 其 他 MACHINE 设 置 ) : 


MACHINE = "beaglebone" 


你 之 前 曾 将 相同 的 构建 环境 用 于 qemux86 构 建 系统 ， 这 是 没有 关系 的 ，qemux86 是 基于 x86 架 构 的 机 器 。 然 而 ， 如 果 你 倾向 于 把 东西 分 开 ， 那 么 ， 
你 可 以 通过 引用 oe-init-build-env 来 创建 新 的 构建 环境 。 如 果 确 实 这 么 做 了 ， 那 么 要 确保 为 你 前 面 使 用 过 的 目录 设置 DL_DIR 和 SSTATE_DIR。 它 节省 大 


量 用 于 下 载 共享 源 包 和 重新 创建 架构 间 共 享 的 构建 制品 的 时 间 。 


现在 用 以 下 命令 开始 构建 : 
9 bitbake -k core-image-minimal 


一 旦 构建 完成 ， 你 可 以 在 构建 环境 的 tmp/deploWimages/beaglebone 子 目录 中 找到 用 于 引导 加 载 程 序 、Linux 内 核 和 根 文 件 系统 的 镜像 。Poky 整 
齐 地 把 用 于 不 同 机 器 的 镜像 分 开 到 它们 上 自己 的 目录 中 ， 避 免 它们 混合 在 一 块 。 


现在 你 用 这 些 镜像 做 什么 ? 
理解 BeagleBone 启 动 过 程 


为 了 能 够 启动 目标 硬件 ， 你 需要 理解 目标 硬件 在 我 们 的 例子 中 是 BeagleBone) 如 何 启动 它 的 操作 系统 。BeagleBone 以 特定 的 方式 从 它 的 外 部 SD 
卡 中 启动 。 在 BeagleBone.org 上 ， 你 能 够 找到 这 个 信息 。 对 此 总 结 如 下 : 


1. 通 电 复 位 (Power-On-Reset，POR) 后 ，BeagleBone 的 片上 系统 从 它 的 板 载 KOM 中 加 载 和 运行 阶段 (stage) 0 引导 加 载 程序 。 


2. 阶 段 0 引 导 加 载 程序 访问 名 为 MLO 的 文件 ， 它 必须 位 于 SD 卡 第 一 个 分 区 的 第 一 个 扇 区 中 。MLO 是 阶段 15| 导 加 载 程序 ， 它 是 由 U-Boot 的 二 次 程序 
加 载 器 (Secondary Program Loader, SPL) 功能 性 实现 的 。 


3.U-Boot 二 次 程序 加 载 器 MLO 配 置 BeagleBone 的 片 外 (off-chip) 内 存 ， 然 后 加 载 文 件 u-boot.img， 它 是 完整 的 U-Boot 引 导 加 载 程序 。 在 这 个 
过 程 中 ，U-Boot 是 阶段 23| 导 加 载 程序 。 


4. 然 后 ，U-Boot 加 载 Linux 内 核 镜 像 到 内 存 中 ， 并 且 把 控制 传 给 Linux 内 核 。U-Boot 默 认 要 求 内 核 镜 像 ulmage 位 于 SD 卡 第 二 分 区 的 /poot 目 录 中 。 
第 二 分 区 包含 具有 用 于 BeagleBone 的 完整 根 文 件 系统 的 Linux ext3 文 件 系统 。 


5. 接 着 ，Linux 内 核 开 始 它 的 局 动 过 程 ， 按 照 由 引导 加 载 程序 提 供 的 内 核 命令 行 的 指示 挂 载 根 文件 系统 ， 并 且 最 终 启动 第 一 个 用 户 空 间 进 程 。 


SD 卡 要 求 一 个 具有 两 个 分 区 的 特定 布局 : 一 个 FAT 局 动 分 区 和 一 个 包含 根 文件 系统 的 Linux 分 区 。 用 于 根 文 件 系 统 的 Linux 分 区 可 以 是 任何 Linux 支 持 
的 文件 系统 ， 例 如 ext3 和 ext4。Poky 构 建 系统 顶级 目录 内 的 文件 README.hardware 摘 述 了 如 何 创建 分 区 和 格式 化 它们 。 


创建 局 动 SD 卡 


你 可 以 通过 遵循 说 明和 使 用 命令 fdisk、mkfs.vfat、mkfs.ext3 来 手动 地 启动 BeagleBone 以 完成 SD 卡 的 分 区 和 格式 化 。 然 而 ， 用 小 脚本 自动 化 这 个 
过 程 是 更 加 方便 的 。 程 序 清单 10-1 显 示 了 用 于 为 BeagleBone 分 区 和 格式 化 SD 卡 的 脚本 。 


程序 清单 10-1 用 于 分 区 和 格式 化 BeagleBone SD 卡 的 脚本 


# (c) bbonesd.sh, 2015, Rudolf J Streif 
#!/bin/sh 


echo "Partitioning and formatting SD card for BeagleBone" 


# test for the most common problems 


test “Sid <a)" k= “0” } 
&& echo "You need to be root" to run this script." y 
&& exit 1 


test -z "$1" && \ 
echo "No disk device specified." \ 


&& exit 1 

test "$1" = "/dev/sda" \ 
&& echo "OOPS - System disk specified: ${1}" \ 
&& exit 1 


# be sure before continuing 

echo "Are you sure that you want to format ${1}? Type YES to proceed." 
read RESPONSE 

test "SRESPONSE" != "YES" && echo "Exiting." && exit 1 


# now do the job 
DRIVE=$1 
if [ -b "SDRIVE" ] ; then 
dd if=/dev/zero of=SDRIVE bs=1024 count=1024 
SIZE= fdisk -1 $DRIVE | grep Disk | awk '{print $5}'° 
echo DISK SIZE - SSIZE bytes 
CYLINDERS=*‘echo $SIZE/255/63/512 | De` 


echo CYLINDERS - SCYLINDERS 
{ 

echo ,;9,0x0C,% 

echo ,200,0x83,- 


echo »,0x83,= 
} | sfdisk -D -H 255 -S 63 -C $CYLINDERS $DRIVE 
if [[ $1 == '/dev/sd'* ]] ; then 


mkfs.vfat -F 32 -n "beagboot" S{DRIVE}1 
mkfs.ext3 -L "beagroot" ${DRIVE}2 
else 
mkfs.vfat -F 32 -n "beagboot" ${DRIVE}p1 
mkfs.ext3 -L "beagroot" ${DRIVE}p2 
EF 
EL 
echo Done. 


在 你 把 3D 卡 插入 进 开 友 系统 ， 用 dmesg 命 令 确 定 设备 : 


9 dmesg 

[ 4389.803854] sd 9:0:0:1: [sdf] 15278080 512-byte logical blocks: \ 
(7.82 GB/7.28 GiB) 

[ 4389.822434] sdf: sdfl 


在 这 个 例子 中 ，SD 卡 已 经 被 认 作 成 了 /dewsdf， 所 以 你 需要 用 
S sudo ./bbonesd.sh /dev/sdf 


来 调用 脚本 。 


脚本 工作 于 被 认 作 SCSI 驱 动 (/dewWsd*， 通 遂 ， 当 用 一 个 USB 读 卡 器 连接 时 ) 的 SD 卡 以 及 被 认 作 内 存 块 设备 (/dev/mmcblk*， 通 常 ， 当 插入 计算 
机 的 一 个 卡 槽 时 ) 的 SD 卡 。 


既然 分 区 和 格式 化 了 SD 卡 ， 那 么 需要 复制 引导 加 载 程序 和 根 文件 系统 到 它们 各 目的 分 区 。 以 下 假设 局 动 分 区 被 挂 载 企 /media/beagboot， 根 分 区 被 
丰 载 在 /media/beagroot。 如 果 你 的 系统 把 它们 挂 载 到 不 同 的 挂 载 点 上 ， 那 么 需要 对 应 地 做 出 调整 。 从 构建 环境 的 顶级 目录 中 ， 改 变 到 具有 用 于 


Beaglebone 的 镜像 的 目录 : 


S cd tmp/deploy/images/beaglebone 


复制 引导 加 载 程序 文件 到 局 动 分 区 中 


S sudo cp MLO /media/beagboot 
S sudo cp u-boot.img /media/beagboot 


解压 根 文件 系统 和 内 核 模块 到 根 分 区 中 : 


9 tar x -C /media/beagroot -ft core-image-minimal.tar.bz2 
S tar x -C /medai/beagroot -f modules-beaglebone.tgz 


复制 内 核 镜像 和 设备 树 文件 到 根 分 区 的 /boot 目 录 中 : 
S cp zImage /media/beagroot/boot 


S cp zImage-am335x-bone.dtb /media/beagroot/boot/am335x-bone.dtb 
$ cp zImage-am335x-boneblack.dtb /media/beagroot/boot/am335x-boneblack.dtb 


复制 和 解压 文件 可 能 要 花费 一 些 时 间 。 即 使 当 最 后 的 命令 返回 了 ， 进 程 也 可 能 没有 完成 ， 因 为 Linux 对 硬盘 操作 提供 了 写 缓冲 。 使 用 
S sync 
来 冲刷 所 有 组; 站 并 且 在 印 载 和 移 除 SD 卡 之 前 等 待命 令 返 回 。 如 果 你 从 命令 行使 用 umount， 那 么 在 逢 载 之 前 ， 它 等 待 文件 系统 缓冲 被 ;中 刷 ， 因 为 在 
文件 系统 被 实际 卸载 前 Sync 是 被 umount 调 用 的 。 


现在 ， 已 经 准备 好 局 动 BeagleBone 板 。 
启动 BeagleBone 


为 了 启动 BeagleBone 板 并 日 遵循 尼 的 启动 过 程 ， 你 需要 为 它 提供 电力 并 且 连 接 它 的 控制 台 串 口 到 你 的 开发 系统 。 如 果 你 自己 调用 
BeagleBone (White) ， 那 么 启动 是 非常 简单 直接 的 。 如 果 你 拥有 一 个 BeagleBone Black， 那 么 你 需要 进行 一 些 额外 的 步骤 。 
连接 BeagleBone (White) 
为 了 连接 BeagleBone (White) 到 开发 计算 机 ， 你 需要 一 个 一 映 是 USB A 插 涉 、 另 一 尊 是 一 个 微型 USB 插 头 的 USB 线 绕 。USB A 插头 插 进 你 的 开发 


计算 机 ， 微 型 USB 插 头 插 进 BeagleBone (White) 下 侧 的 USB 端 口中 。USB 线 缆 提供 电力 ， 也 提供 介 于 BeagleBone 的 控制 台 端 口 和 你 的 开发 系统 之 间 
的 串 行 连接 。 因 为 BeagleBone (White) 自 带 USB 线 纱 ， 所 以 不 需要 额外 的 硬件 。 


在 连接 板 之 前 ， 把 SD 卡 插 进 BeagleBone (White) 的 SD 卡 槽 中 。 
连接 BeagleBone Black 


连接 BeagleBone Black 要 稍微 更 难 一 点 儿 ， 因 为 这 个 板 没有 内 置 的 串 行 到 USB 的 转换 器 。 你 需要 外 部 的 串 行 到 USB 的 转换 器 线 费 ， 而 BeagleBone 
Black 没 有 提供 。 这 些 线 缆 通 常 称 为 FTDI 线 绕 ， 是 以 生产 转换 器 芯片 和 线 绕 的 公司 Future Technology Devices International Ltd. 首 字母 命名 的 。 


BeagleBone Black 在 它 的 顶部 有 一 个 6 针脚 、 单 列 0.1 英 寸 (1 英 二 =25.4 毫 米 ) 间距 的 连接 器 。 这 是 用 于 它 的 串 行 控制 侣 端口 的 连接 器 。 为 了 连接 到 
它 ， 需 要 一 根 一 端 是 USB A 连 接 器 而 另 一 端 是 6 向 、 单 列 连 接 器 的 串口 到 USB 转 换 器 线 缆 。 你 也 需要 注意 BeagleBone Black 串 行 控制 台 端 口 的 信号 电 平 
是 3.3V。 也 有 用 于 5V 信 号 电 平 的 线 绕 ， 对 BeagleBone 使 用 5V 线 绕 可 能 损坏 板 的 CPU。 正 确 的 线 绕 是 FTDI TTL-232R-3V3。 你 可 以 在 FTDI 的 网 站 上 找到 
它 


出 。 大 部 分 组 件 配 电器 携带 这 类 线 缆 。 


为 了 连接 线 编 到 板 ， 把 它 设置 成 项 部 表 上 ， 以 太 网 和 5V 电 力 连 接 器 朝 左 。 绪 编 连 接 器 的 黑 线 连 到 板 连 接 器 的 最 左 侧 的 针脚 。 那 个 针脚 在 板 上 以 一 个 
小 日 点 标示 出 来 。 


捉 行 到 USB 的 转换 器 线 绕 不 为 BeagleBone 提 供电 力 。 你 可 以 连接 一 个 能 够 提供 至 少 1.2A (或 者 6W) 的 5V 电 源 到 桶 形 连接 器 ， 或 者 使 用 一 个 USB A 
到 微型 USB 线 统 。 在 大 部 分 情况 下 ， 后 者 可 能 更 加 容易 ， 因 为 BeagleBone Black 目 市 了 这 样 一 根 线 编 。UsB 续 缆 连 接 到 BeagleBone Black 底 部 的 微型 


USB 端 口 。 
设置 终端 模拟 器 


为 了 通过 串 行 连接 与 BeagleBone 人 交互 ， 你 需要 终端 模拟 程序 。 对 于 Linux 有 几 个 选择 ， 我 们 推荐 Minicom。 几 乎 所 有 Linux 皮 行 版 通过 其 包 仓 库 提 
供 Minicom。 如 果 它 还 没有 安 委 人 在 你 的 系统 上 ， 那 么 使 用 你 的 友 行 版 的 包 管 理 器 来 安装 它 。 


所 有 当前 的 Linux 系 统 都 把 FTDI 串 行 到 USB 的 转换 器 识别 成 ttyUSB 设 备 。 在 你 把 BeagleBone 插 到 开发 计算 机 的 USB 端 口 后 ， 设 备 节 
点 /dewttyUSB0b] 由 Linux 内 核 创建 。Linux 内 核 防止 设备 节点 受到 普通 用 户 的 访问 。/dewttyUSB 设 备 是 由 root 拥 有 的 ， 但 通常 属于 dialout 用 户 组 。 为 
了 使 Minicom 能 够 于 运行 时 在 你 的 用 户 账 号 下 访问 设备 ， 你 需要 增加 自己 到 dialout 用 户 组 中 。 


S sudo usermod -a -G dialout <username> 


其 中 ， 可 用 你 的 实际 用 户 名 蔡 换 <username> 。 为 了 使 变更 生效 ， 你 需要 登 出 并 再 次 登录 。 
现在 连接 你 的 BeagleBone 到 计算 机 并 且 以 设置 模式 启动 Minicom[oj: 


S sudo minicom -s 


在 此 时 ， 你 应 该 能 够 看 到 Minicom 的 设置 菜单 。 选 择 Serial port setup 菜 单 选项 并 改变 设置 : 
- 设置 Setial Device 为 /dev/ttyUSB0。 
. 设置 Bps/Par/Bits 为 1152008N1。 
- 设置 Hardware Flow Control 为 No (如 必要 ) 。 
- 设置 Softwate Flow Control 为 No (如 必要 ) 。 
按 下 Enter 键 从 Serial port setup 菜 单 中 退出 ， 然 后 从 主 设 置 菜单 中 选择 Save as dfl。 最 终 ， 从 Minicom 退 出 。 
现在 再 次 用 以 下 命令 局 动 Minicom: 
S$ sudo minicom -o -w 


-0 选项 告诉 Minicom 不 给 你 的 BeagleBone 友 送 任何 调制 解 调 器 初始 化 字符 串 ，-w 选 项 为 长 日 志 行 打开 换行 。 


现在 你 已 经 连接 到 BeagleBone 的 控制 台 。 如 果 你 的 板 是 BeagleBone (White) , 那么 它 可 能 已 经 启动 了 。 如 果 在 键盘 上 熟 击 Enter 键 ,那么 应 该 能 
看 到 类 似 如 下 的 Linux 登 录 提 示 : 


Poky (Yocto Project Reference Distro) 1.8+snapshot-20150720 beaglebone \ 
/dev/tty00 
beaglebone login: 


如 果 你 的 板 是 BeagleBone Black, #fhAteaxTHEnter#eAy, (KASERGSIU-Bootiz=m. RAZ, BeagleBone Black 有 内 部 eM MK 和 存储， 而 
BeagleBone (White) 没有 。 默 认 情况 下 ，BeagleBone Black 首 先 从 它 的 内 部 eMMC 启 动 。 为 了 临时 告诉 BeagleBone Black 从 SD 卡 中 局 动 ， 遵 循 这 


些 步 又 : 
从 板 上 拔除 电源 (依赖 于 你 正在 使 用 什么 ， 有 可 能 是 微型 USB 或 者 5V 桶 形 连 接 器 ) 。 
+ 按 住 板 上 的 USER/BOOT 按 钮 ( 当 以 太 网 和 5V 电源 连接 器 朝向 左 时 ， 这 个 按钮 是 板 顶 部 右上 部 位 的 小 按钮 ) 。 
- 在 按 住 USER/BOOT 按 钮 的 时 候 再 次 插入 电源 ， 直 到 来 自 U-Boot 的 第 一 条 消息 显示 在 你 的 Minicom 窗 口中 。 然 后 ， 可 以 释放 USER/BOOT 按 钮 。 
你 的 BeagleBone 启 动 并 且 最 终 显示 Linux 登 录 提 示 。 


从 U-Boot 命 令 提示 中 友 出 这 些 命令 ,你 可 以 永久 性 地 把 局 动 顺序 从 内 部 eMMC 改 到 SD 卡 : 


mmc dev 1 
mmc erase 0 512 


把 内 容 从 内 部 eM MC 中 擦 除 。 
从 Linux 命 令 行 提示 中 ， 你 可 以 登录 进 正 运行 在 BeagleBone 上 的 系统 中 。 
恭喜 ! 你 已 经 成 功 为 嵌入 式 板 创建 了 Yocto 项 目镜 像 ， 并 用 它 来 启动 板 。 


[1] http://beagleboard.org/about. 

[2] 对 谱 入 式 系 统 来 说 ， 没 有 显示 器 是 常见 的 ， 因 为 它们 可 能 不 需要 显示 器 ， 例 如 在 工业 控制 中 。 虽 然 显 示 器 可 以 通过 cape 或 者 HDMI 增 加 到 BeagleBone， 
但 是 设计 者 决定 不 这 样 做 ， 而 是 让 硬件 架构 保持 开放 和 可 扩展 。 

[3] www.seeedstudio.com/wiki/Grove_System. 

[4] www.ftdichip.com/Products/Cables/USBTTLSerial.htm. 

[5] 除非 你 有 不 止 一 个 囊 行 到 USB 的 转换 器 被 连接 到 开发 系统 上 ， 在 这 种 情况 下 ， 有 多 个 /dev/ttyUSB 设 备 ， 你 必须 找 出 哪 一 个 连接 到 你 的 BeagleBone。 


[6] 以 设置 模式 运行 Minicom 需 要 root 权 限 。 


10.2.2 ”外 部 Yocto 项 目 板 支持 包 


物 联网 和 创 客运 动 (Maker Movement) 正在 驱动 对 廉价 计算 机 硬件 的 需求 。 专 业 开 发 者 和 兴趣 爱好 者 [同样 在 寻找 可 以 用 于 设计 和 原型 并 与 项 目 
集成 的 开发 板 。 围 绕 大 量 片 上 系统 构建 的 可 用 板 的 数量 正在 稳步 增加 。 绝 大 部 分 是 基于 ARM 架 构 的 硅 片 ， 但 是 也 可 以 找到 基于 x86、x86_64、xScale 和 和 
PowerPC 架 构 的 。Raspberry Pi 为 能 够 运行 完整 Linux 操 作 系统 栈 的 低 成 本 谨 入 式 计算 机 树立 了 新 基准 。 其 他 板 也 纷纷 效仿 ， 其 中 很 多 只 花费 和 在 像样 的 
餐厅 里 吃 顿 不 错 的 饭 一 样 的 钱 。 


流行 开 友 板 


表 10-1 以 字母 顺序 显示 了 一 些 比 较 流行 的 能 够 运行 Linux 的 开 友 板 。 它 们 都 提供 各 种 低速 /O 接 口 ， 这 些 接口 是 可 通过 针脚 头 直接 访问 的 。 对 于 它们 
中 的 一 些 来 说 ， 直 接 插 到 针脚 头 上 的 扩展 板 是 可 用 的 。 扩 展板 提供 各 种 乐 西 ， 从 市 LED 状 态 和 中 继 器 的 并 行 MO、 模 拟 - 数 字 转 损 器 (Analog-to-Digital 
Converter, ADC) 和 数字 -模拟 转换 器 (Digital-to-Analog Converter, DAC) ， 到 用 于 机 器 入 应 用 的 步 进 电动 机 驱动 器 等 。 


表 10-1 只 展示 了 在 写作 本 书 时 市 面 上 的 部 分 开发 板 。 伴 随 每 个 新 一 代 片 上 系统 ， 新 的 开发 板 也 几乎 同步 地 进入 市 场 。 
为 你 的 板 寻 找 Yocto 项 目 板 支持 包 


一 旦 你 决定 了 用 于 开 上 项 目的 板 ， 那 么 你 将 人 在 哪里 找到 Yocto 项 目 板 叉 持 包 文 持 的 开 友 板 呢 ? 最 好 是 浏览 板 目 己 的 网 站 。 在 很 多 情况 下 ， 你 可 以 找到 
Yocto 项 目 或 者 提供 硬件 支持 的 社区 的 链接 。 
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Yocto 项 目 在 它 的 网 站 维护 了 一 个 可 搜索 的 板 支持 包 [ 包 页 面 ， 该 页 面 展 示 了 开发 板 和 Yocto 项 目 仓 库 里 的 板 支持 包 的 一 个 概览 。 这 些 包 是 由 组 织 提供 
的 ， 有 商业 的 和 开源 的 ， 它 们 为 Yocto 项 目 提供 资源 和 开发 工作 [31, 


一 部 分 作为 Yocto 项 目 兼 容 列 出 ， 这 是 作为 Yocto 项 目 对 文 持 该 项 目的 组 织 的 一 个 认可 的 状态 。Yocto 项 目 兼容 并 不 意味 着 不 具有 那个 状态 的 层 是 不 
兼容 的 ， 仅 仅 是 说 那些 由 Yocto 项 目 兼 容 所 列 出 的 层 已 经 经 过 了 审查 并 且 是 由 一 个 Yocto 项 目 成 员 组 织 支 持 的 。 


Yocto 项 目 Git 仓 库 欠 托管 很 多 板 支持 包 层 ， 包 括 那些 未 被 Yocto 项 目 官方 认证 的 板 支持 包 层 。 板 支持 包 层 的 列表 包含 如 下 内 容 : 
. meta-fsl-arm: 用 于 使 用 基于 ARM 架 构 的 片上 系统 的 Freescale 平 台 的 板 支持 包 层 。 
meta-fsl-ppc: 用 于 使 用 基于 PowerPC 架 构 的 片上 系统 的 Freescale 平 台 的 板 支持 包 层 。 
-meta-intel: 用 于 基于 x86 和 x86_64 架 构 的 Intel 平 台 的 复合 板 支持 包 层 。 这 个 层 包 含 多 个 用 于 实际 平台 的 子 层 。 
- meta-intel-galileo: 用 于 Intel Galileo 平 台 支 持 的 板 支持 包 层 。 
- meta-intel-quark: 用 于 Intel Quatk 平 台 支 持 的 板 支 持 包 层 。 
. meta-minnow: 用 于 原始 MinnowBoard ( 非 MinnowBoard Max， 它 是 由 meta-intel 支 持 的 ) 的 板 支持 包 层 。 
- meta-raspberrypi: 用 于 Raspberry Pi 1 和 Raspberry Pi 2 设备 的 板 支 持 包 层 。 
- meta-renesas: 用 于 Renesas 设 备 的 板 支持 包 层 。 
-meta-ti: 用 于 Texas Insttuments 设 备 的 板 支 持 包 层 ， 包 括 对 BeagleBone 的 扩展 的 硬件 支持 ， 这 种 支持 不 由 meta-yocto-bsp 提 供 。 
- meta-xilinx: 用 于 Xilinx 设 备 的 板 支持 包 层 。 
-meta-zyng: 用 于 Zynq 设 备 的 板 支持 包 层 。 


最 后 但 并 非 最 不 重要 ，OpenEmbedded 网 站 bp 提供 了 包含 由 各 种 社区 提供 的 很 多 板 支持 包 的 可 搜索 层 索 引 。 搜 索 功能 允许 按照 机 器 名 搜索 ， 并 且 列 
出 为 那个 机 器 提供 支持 的 层 。 有 时 候 ， 用 于 相同 机 器 的 多 个 层 可 用 ， 它 们 为 板 提供 的 支持 的 级 别 可 能 有 差别 。 


用 外 部 Yocto 项 目 板 支 持 包 构 建 
Yocto 项 目 板 支持 包 是 层 ， 用 它们 来 构建 简单 到 只 有 3 步 : 
1. 通 过 增加 板 支 持 包 层 的 路 径 到 conf/bblayers.conf 中 的 BBLAYERS 变 量 来 在 你 的 构建 环境 中 包含 它 。 
2. 把 你 希望 从 板 支 持 包 层 构建 的 机 器 赋值 到 conf/local.conf 中 的 MACHINE 变 量 。 


3. 选 择 镜像 目标 并 且 开 始 你 的 构建 一 一 例如 ，bitbake-k core-image-minimal。 以 仅仅 能 够 启动 到 控制 台 命 令 行 的 小 镜像 开始 是 好 建议 ， 例 如 
core-image-minimal 或 者 core-image-base。 如 果 正 常 工 作 ， 那 么 你 可 以 测试 例如 core-image-sato 的 更 大 的 镜像 或 者 开始 构建 你 自己 的 定制 镜像 菜 
谱 。 一 些 板 支 持 包 包含 自己 的 镜像 目标 ， 这 也 是 一 个 好 起 点 。 


当 使 用 Yocto 项 目 板 支 持 包 时 ， 需 要 注意 ， 板 支持 包 版 本 匹配 OpenEmbedded 构 建 系 统 的 版 本 。 板 支持 包 通 常用 bbappend 文 件 来 扩展 来 自 
OpenEmbedded 核 心 的 菜谱 。 如 果 版 本 不 匹配 ， 那 么 有 可 能 是 ， 由 板 支 持 包 扩展 的 各 个 菜谱 的 版 本 与 在 核心 层 中 找到 的 版 本 不 匹配 。 如 果 这 种 情况 发 


生 ， 那 么 BitBake 为 各 个 菜谱 发 出 错误 消息 ， 但 是 根本 原因 却 不 忌 是 显而易见 的 。 


Yocto 项 目 开发 者 对 主要 发 布 使 用 代号 : 1.5 是 Dora、1.6 是 Daisy、1.7 是 Dizzy、1.8 是 Fido、2.0 是 Jethro。 虽 然 你 可 以 从 Yocto 项 目 网 站 [oj 下 载 发 布 
的 tar 包 ， 但 是 推荐 你 从 Yocto 项 目 Git 仓 库 中 检 出 友 布 版 。 使 用 Git 仓 库 有 利于 追踪 版 本 甚至 在 版 本 间 切 换 。 例 如 ， 如 果 你 希望 使 用 meta-ti 层 替代 meta- 
yocto-bsp 来 为 BeagleBone 构 建 ， 那 么 简单 地 从 poky 和 meta-ti 仓 库 中 克隆 匹配 的 分 支 : 


9 git clone git://git.yoctoproject.org/poky -b fido 
S git clone git://git.yoctoproject.org/meta-ti -b fido 


另外 一 个 需要 注意 的 事情 是 ， 虽 然 板 支持 包 通 常 不 互相 影响 ,但 是 存在 在 机 器 定义 中 有 重合 的 板 支 持 包 ,例如 meta-yocto-bsp 和 meta-ti， 它 们 的 
beaglebone 机 器 定义 重合 。 为 了 避免 冲突 ， 必须 用 BBLAYERS 仅 仅 包 含 其 中 一 个 。 简 言 之 ， 在 一 个 构建 环境 中 同时 仪 包含 一 个 板 支 持 包 层 是 好 建议 。 


[1] 区 分 专业 开发 者 和 兴趣 爱好 者 时 ， 不 是 基于 他 们 的 能 力 ， 而 是 看 他 们 是 将 举 入 式 系 统 作为 工作 的 一 部 分 还 是 作为 兴趣 爱好 。 

[2] https://www.yoctoproject.org/downloads/bsps o 

[3] Æ “free and open source software (FOSS) ” #49 “free” 是 指 自由 ， 而 不 是 指 成 本 。 寻 求 Yocto 项 目 兼容 性 证 书 的 组 织 以 供 开 发 使 用 的 资源 和 基础 设施 
来 支持 项 目 。 

[4] http://git-yoctoproject.orge 

[5] http: //openembedded.org/wiki/Main_Page. 


[6] https://www.yoctoproject.org/downloads o 


10.3 Yocto 项 目 板 文 持 包 内 部 


Yocto 项 目 板 文 持 包 是 特殊 化 的 BitBake 层 。 正 因为 如 此 ， 它 们 遵循 第 3 章 讨论 的 用 于 层 的 惯例 ， 也 包含 版 广 持 包 层 特有 的 项 。 程 序 清 单 10-2 摘 述 了 
一 般 的 板 支 持 包 层 布局 。 


程序 清单 10-2 Yocto 项 目 板 支持 包 层 布局 


meta-<bspname> 
H- LICENSE 
广 - MAINTAINERS 


| 一 README 

| 一 README.sources 

— binary 

| L— <bootable-image-1> 
| L— <bootable-image-2> 


|! ns 
| L— <bootable-image-n> 
— conf 


— layer.conf 

—-— machine 

| | 一 <machine-1>.conf 

| | 一 <machine-2>.conf 

| | 一 ... 

| L— <machine-m>.conf 
— classes 

上 六- class-<1>.bbclass 

-~ class-<2>.bbclass 


L— class<m>.bbclass 
— recipes-bsp 
-~ formfactor 
| 一 formfactor_0.0.bbappend 
L— formfactor 
-— machine-1 
| L— machconfig 
-— machine-2 
| _— machconfig 


| 

| 

| 

| 

| 

| 

| 四 
| L— machine-m 

| L machconfig 

—-— <package a> 

| | 一 <package a>_<version 1>.bb 
| L— <package a>_<version 2>.bb 
g 


<package b> 
| 一 <package b>_<version 1>.bb 
| L— <package b>_<version 2>.bb 


| 

| 

| 

| 

| 

| 

= 

| 

| 

| 

| 

= 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| a 
| L— <package z> 

—-— recipes-core 

| —— images 

| | -— core-image-1.bb 

| | | 一 core-image-2.bb 

| | — ... 

| | L— core-image-n.bb 

| L a’ 

—-— recipes-graphics 

| —-— <package a> 

| | -— <package a>_<version 1>.bb 
| | L— <package a>_<version 2>.bb 
| —-— <package b> 

| | | 一 <package b>_<version 1>.bb 
| | L— <package b>_<version 2>.bb 
| — ... 

| L— <package z> 

-~ recipes-kernel 

| —— linux 

| | | 一 linux-yocto_<version 1>.bbappend 
| | L— linux-yocto_<version 2>.bbappend 
L 


— recipes-<category x> 
= 


这 个 结构 的 大 部 分 是 约定 俗 成 的 。 然 而 ,构建 系统 期 望 特定 目录 和 文件 在 特定 位 置 被 特殊 化 地 命名 。 像 任何 层 一 样 ， 层 的 顶级 目录 被 命名 为 meta- 
<layername>， 其 中 layername 是 板 支 持 包 的 名 字 。 


10.3.1 许可 文件 


许可 文件 位 于 板 支 持 包 的 顶级 目录 。 它 们 可 以 上 县 有 任何 名 字 ， 但 通常 使 用 的 是 LICENSE、EULA 和 COPYING 等 名 字 。 


从 构建 系统 不 寻找 许可 文件 并 且 不 强制 其 存在 性 这 个 意义 上 来 说 ， 许 可 文件 是 可 选 的 。 然 而 ,我 们 强烈 建议 ， 在 写 你 自己 的 板 支 持 包 时 ， 提 供 许 可 
文件 。 提 供 许 可 文件 给 了 你 的 板 支 持 包 用 户 天 于 可 以 用 板 支 持 包 做 什么 以 及 不 能 做 什么 的 确定 性 。 


10.3.2 ”维护 者 文件 


维护 者 文件 包含 天 于 谁 是 开 友 者 以 及 谁 负责 维护 板 支 持 包 的 信息 。 这 个 文件 是 可 选 的 ， 而 且 维 护 者 信息 通常 包含 在 顶级 目录 的 README 文 件 中 。 如 
果 板 支持 包 有 多 个 (可 能 很 多 ) 维护 者 ， 那 么 在 单独 的 文件 中 提供 这 个 信息 很 有 意义 。 


10.3.3 ”READMExX 件 


符合 Yocto 项 目的 板 支 持 包 必须 在 板 支 持 包 的 顶级 目录 中 包 售 README 文 件 。 这 个 文件 至 少 应 该 包含 下 列 信息 : 
- 描述 板 支持 包 及 其 针对 的 硬件 的 部 分 。 


详细 描述 用 于 这 个 板 支 持 包 层 的 所 有 依赖 性 的 部 分 。 通 常 ， 这 是 例如 meta 和 meta-yocto 的 其 他 层 。 几 乎 所 有 板 支 持 包 都 依赖 OpenEmbedded 核 心 元 
数据 层 meta。 虽 然 看 起 来 是 显而易见 的 ， 但 是 把 它 包 含 在 依赖 性 列表 中 是 好 的 实践 。 


" 用 于 提问 、 报 告 缺 陷 和 提交 补丁 的 指导 方针 部 分 。 这 些 信息 使 得 用 户 和 维护 者 可 轻松 地 沟通 和 协作 。 
-如果 单独 文件 没有 提供 ， 那 么 需要 关于 维护 板 支持 包 的 开发 者 的 部 分 。 

` 关于 如 何 使 用 板 支持 包 为 目标 硬件 构建 二 进 制 镜像 的 说 明 。 

关于 用 板 支持 包 构 建 的 镜像 可 以 如 何 安 装 在 目标 硬件 以 及 如 何 居 动 目标 硬件 的 说 明 。 

“ 关于 如 何 使 用 板 支持 包 binary 目 录 包 含 的 预 构 建 二 进 制 镜像 (如 果 板 支持 包 提 供 此 类 镜像 ) 的 说 明 。 
- 关于 板 支 持 包 用 户 在 使 用 板 支持 包 时 应 该 知道 的 任何 已 知 缺 陷 或 者 问题 的 部 分 。 


在 README 文 件 内 的 信息 越 详细 ， 对 板 文 持 包 用 户 来 说 越 容易 成 功 地 在 它们 的 项 目 中 包含 板 文 持 包 以 及 使 用 目标 硬件 。 


10.3.4 README.sources 文 件 


这 个 文件 提供 用 尸 可 以 在 哪里 找到 用 来 构建 位 于 二 进 制 目录 中 的 可 局 动 镜像 的 源 文件 的 信息 。 通 常 ， 这 些 是 曾 被 用 来 创建 镜像 的 元 数据 屋 。 这 对 于 
READMEx 文 件 中 的 依赖 性 信息 似乎 是 匈 余 的 。 然 而 ， 它 却 不 见 余 ， 因 为 用 来 构建 镜像 的 构建 环境 可 能 已 经 包含 了 其 他 可 选 但 不 必需 的 层 。 


10.3.5” 预 构建 一 进 制 


板 支 持 包 可 能 在 binary 子 目录 中 包含 预 构建 的 可 启动 镜像 二 进 制 。 虽 然 包含 可 启动 镜像 是 可 选 的 ， 但 是 它 辅助 板 支 持 包 的 用 户 来 用 一 个 已 知 良好 镜 


像 局 动 目标 硬件 。 利 用 预 构建 的 镜像 二 进 制 和 在 README.sources 文 件 中 的 信息 ， 用 尸 可 以 通过 比较 自己 构建 的 镜像 和 预 构 建 的 镜像 来 更 加 容易 地 调试 
可 能 出 现在 镜像 中 的 问题 。 当 然 ， 增 加 预 构建 的 镜像 二 进 制 可 能 极 大 地 增加 板 支 持 包 的 大 小 。 


10.3.6 Feacesc+ 

像 任 何 层 ， 板 支持 包 必 须 包 含 层 配置 文件 conf/layer.conf。 对 于 板 文 持 包 来 说 ， 这 个 文件 和 普通 层 用 到 的 层 配置 文件 宫 无 两 样 。 样 板 文 件 显 示 在 程 
序 清单 10-3 中 。 

程序 清单 10-3 ”用 于 板 支 持 包 的 层 配 置 文件 


# We have a conf and classes directory, add to BBPATH 
BBPATH .= ":S{LAYERDIR}" 


# We have a recipes directory, add to BBFILES 
BBFILES += "S${LAYERDIR}/recipes-*/*/*.bb \ 
S{LAYERDIR}/recipes-*/*/* .bbappend" 
BBFILE COLLECTIONS += "bsp" 
BBFILE_PATTERN_bsp = "“S{LAYERDIR}/" 
BBFILE PRIORITY_bsp = "6" 
LAYERDEPENDS_bsp = "<deplayer>" 
为 了 使 用 这 个 样板 ， 必 须 蔡 换 bsp 为 层 的 实际 名 字 (不 带 meta-) 。 如 果 板 文 持 包 层 依赖 其 他 层 ， 例 如 用 于 多 个 板 文 持 包 的 通用 层 ， 那 么 层 配 置 文件 
设置 LAYERDEPENDS_bsp 变 量 为 由 空格 分 隔 的 层 的 列表 。 


10.3.7 ”机 器 配置 文件 


机 器 配置 文件 用 于 区 分 板 支 持 包 层 和 普通 层 。 板 支持 包 层 包含 至 少 一 个 机 器 配置 文件 ， 但 是 在 confWmachine 子 目录 中 可 以 有 任何 数量 的 、 用 于 由 板 
支持 包 支 持 的 不 同 硬件 的 机 器 配置 文件 。 机 器 配置 文件 被 命名 为 <machinename>.conf。 通 过 设置 构建 环境 的 conf/local.conf 中 的 MACHINE 变 量 为 机 
器 配置 文件 的 名 字 (不 带 .conf 结 尾 ) 来 选择 你 希望 的 机 器 目标 。 


简 言 之 ， 机 器 配置 文件 包含 用 于 选择 和 配置 由 包含 在 板 支 持 包 或 者 其 他 元 数据 层 中 的 菜谱 所 构建 的 软件 包 的 设置 。 典 型 的 例子 是 板 广 持 包 为 特定 机 
器 使 用 的 Linux 内 核 类 型 和 版 本 。 机 器 配置 文件 包含 用 于 PREFERRED PROVIDER virtual/kernel 和 PREFERRED VERSION virtual/kernel 的 设置 ， 以 分 
别 选择 内 核 类 型 和 版 本 。 


机 器 配置 文件 通常 也 包含 用 于 目标 硬件 正在 使 用 的 特定 CPU 架 构 的 调 优 参 数 。 这 些 参数 和 在 多 个 机 器 间 共 享 的 其 他 参数 通常 被 分 离 到 它们 各 自 的 文 
件 中 。 这 些 文件 被 require 指 令 包含 在 机 器 配置 文件 中 。 


10.3.8 类 


板 支 持 包 在 classes 子 目录 中 可 能 包含 定制 类 。 这 些 经 党 是 以 目标 硬件 要 求 的 方式 组 装 二 进 制 镜像 的 镜像 类 。 这 样 的 镜像 类 和 它们 所 构建 的 镜像 使 得 
从 镜像 创建 可 局 动 介 质 更 加 容易 。 


10.3.9 有 菜谱 文件 
任何 板 支持 包 都 包含 大 量 菜谱 文件 来 构建 特定 于 板 支持 包 的 软件 包 或 使 用 .bbappend 文 件 来 为 来 自 其 他 层 的 包 扩展 菜谱 。 板 支持 包 的 菜谱 以 和 任何 
其 他 元 数据 层 中 完全 相同 的 方式 组 织 到 recipes-<category>/<package> 子 目录 中 。 以 下 是 在 板 支 持 包 中 找到 的 更 加 常见 的 菜谱 : 


板 支 持 包 特定 菜谱 文件 (recipes-bsp) : 各 式 各 样 的 特定 于 板 支 持 包 的 菜谱 。 通 常 ， 在 recipes-bsp 之 下 的 一 个 目录 结构 中 ， 你 可 以 找到 引导 加 载 
程序 和 规格 (formfactor) 元 数据 文件 。 规 格 文件 为 构建 系统 提供 有 关 目 标 机 器 是 否 使 用 键盘 、 和 触摸 屏 、 鼠 标 等 的 信息 。 


. 核心 支持 文件 (recipes-core) : 在 目录 frecipes-cote 中 ， 通 常 可 找到 用 于 目标 硬件 的 二 进 制 镜像 以 及 针对 init-scfipts、systemd、udev 等 其 他 核心 菜 


谱 的 调整 的 菜谱 。 


- 显示 支持 文件 (recipes-graphics) : 如 果 板 支 持 包 的 目标 硬件 有 特定 的 图 形 需 求 ， 那 么 你 会 在 目录 trecipes-graphics 中 找到 与 显示 支持 有 关 的 菜 
谱 。 通 常 ， 这 些 是 用 于 X11 服 务 器 或 者 Wayland/Weston 合 成 器 的 配置 菜谱 。 


- Linux 内 核 (recipes-kernel) : 目录 recipes-kernel 及 其 子 目录 包含 与 Linux 内 核 有 关 的 菜谱 和 配置 文件 。 通 常 ， 它 们 是 用 来 增加 内 核 配置 片段 到 位 
于 meta 核 心 层 的 内 核 菜 谱 或 内 核 补 丁 的 .bbpabpend 文 件 。 一 些 板 支持 包 提 供 它 们 自己 的 内 核 菜谱 ， 这 些 内 核 菜谱 从 它们 自己 的 仓库 中 构建 Linux 内 核 。 在 第 9 
章 中 ， 我 们 详细 讨论 了 Linux 内 核 配置 和 各 种 参数 设置 。 


- 其 他 菜谱 (recipes-*) : 板 支 持 包 可 能 按照 目标 硬件 的 要 求 增加 它 自己 的 菜谱 或 扩展 来 自 其 他 层 的 菜谱 。 在 板 支持 包 层 内 ， 可 以 在 它们 各 自 菜谱 
子 目 录 中 找到 这 些 菜谱 。 


板 支 持 包 提 供 哪些 菜谱 完全 依赖 于 板 支 持 包 及 其 支持 的 目标 硬件 。 


10.4 创建 Yocto 项 目 板 文 持 包 


如 果 你 正在 开发 自己 的 硬件 ， 那 么 你 希望 创建 Yocto 项 目 板 支 持 包 以 为 其 提供 完整 支持 。 原 则 上 ， 你 可 以 及 用 如 下 3 种 用 于 创建 Yocto 项 目 板 支 持 包 
的 方法 之 一 : 


手动 创建 : 你 可 以 通过 使 用 yocto-layet 脚 本 创建 空 的 层 来 开始 ， 然 后 手动 地 为 板 支 持 包 填 充 目 录 和 文件 。 


. 从 现 有 板 支 持 包 层 复 制 : 如 果 你 的 板 支 持 包 针 对 的 硬件 类 似 于 来 自 另 一 个 板 支持 包 的 硬件 ， 那 么 你 可 以 复制 那个 层 并 且 做 调整 以 满足 你 的 目标 硬 
件 的 需求 。 


使 用 Yocto 项 目 板 支持 包工 具 : Yocto 项 目 提 供 了 几 个 简化 创建 板 支持 包 任 务 的 工具 。 它 们 是 交互 性 的 ， 并 且 允 许 通 过 回答 一 系列 问题 来 设置 常用 
板 支 持 包 参数 。 然 后 ， 工 具 为 你 的 板 支持 包 创 建 胃 架 ， 随 之 你 可 以 填 入 缺失 的 细节 。 


手动 地 从 头 创建 板 支持 包 是 最 之 味 的 方法 ， 因 为 它 要 求 你 目 己 来 增加 文件 和 目录 。 在 几乎 所 有 情况 下 ， 使 用 Yocto 项 目 板 支 持 包 工具 都 是 比较 好 的 选 
项 ， 因 为 其 允许 你 交互 式 地 剪裁 板 支 持 包 层 。 如 果 你 的 目标 硬件 近似 于 被 一 个 现 有 的 板 支 持 包 所 支持 的 硬件 ， 那 么 从 其 复制 是 好 的 选择 。 你 也 可 以 扩展 
其 他 板 支 持 包 并 且 使 其 成 为 用 于 你 板 支 持 包 的 依赖 性 。 这 个 方法 避免 了 重复 ， 但 是 ， 当 你 的 板 支 持 包 依赖 的 其 他 层 友 生变 化 时 ， 丈 需要 维护 你 自己 的 板 
支持 包 。 


10.4.1 Yocto 项 目 板 支持 包工 具 


有 两 个 辅助 你 创建 Yocto 项 目 板 支持 包 的 工具 : yocto-bsp 和 yocto-kernel。 你 可 能 已 经 猪 天 了 ， 前 者 辅助 创建 板 支 持 包 层 ， 后 者 辅助 配置 Linux 内 
核 。 这 两 个 工具 都 有 一 些 子 命令 。 调 用 工具 而 不 指定 子 命令 会 打印 帮助 消息 和 可 用 子 命令 的 列表 。 


工具 位 于 Poky 参 考 发 行 版 的 poky/scripts 目 录 中 。 为 了 使 用 工具 ， 你 必须 引用 oe-init-build-env 脚 本 。 然 而 ， 你 不 用 在 你 的 构建 环境 内 创建 板 支 持 
包 。 一旦 你 引用 了 脚本 ,你 可 以 改变 目录 a 到 你 希望 在 其 中 设置 板 支 持 包 的 地 方 。 


yocto-bsp 工 具 


调用 yocto-bsp 或 者 yocto-bsp help 提 供给 你 关于 可 用 子 命令 的 信息 : 


$ yocto-bsp 
ERROR: root:No subcommand specified, exiting 
Usage: 


Create a customized Yocto BSP layer. 
usage: yocto-bsp [--version] [--help] COMMAND [ARGS] 


Current 'yocto-bsp' commands are: 
create Create a new Yocto BSP 
list List available values for options and BSP properties 


See 'yocto-bsp help COMMAND' for more information on a specific command. 


Options: 
--version show program's version number and exit 
-h, --help show this help message and exit 
-D, --debug output debug information 


工具 有 两 个 子 命令 : create 和 list。 用 yocto-bsp<subcommand>--help 调 用 工具 打印 关于 特定 子 命令 的 进一步 信息 。 
子 命 令 yocto-bsp list 
子 命令 yocto-bsp list 只 显示 信息 。 当 前 ， 这 是 天 于 被 支持 的 内 核 以 构 的 信息 : 


$ yocto-bsp list karch 
Architectures available: 

1386 

mips64 

arm 

powerpc 

mips 

x86_64 

qemu 


对 每 个 内 核 架构 ， 有 一 些 可 用 的 属性 ， 在 创建 板 文 持 包 时 ， 工 具 可 以 设置 它们 。 例 如 ， 
$ yocto-bsp list x86 64 properties 


以 JSON 格 式 显 示 可 用 于 x86_64 染 构 的 全 部 属性 的 列表 。 当 你 为 x86_64 创 | 建 板 支持 包 时 ， 工 具 会 交互 式 地 过 一 遍 那 些 属性 ， 并 间 你 它 应 该 应 用 的 设 


通过 指定 -0<filename> 或 者 --outfile<filename> 参 数 ， 你 可 以 转 存 list 子 命令 的 输出 到 文件 。 
$ yocto-bsp list x86 64 properties -o x84 64.prop 


在 文件 中 的 转 存 也 是 JSON 格 式 。 
子 命令 yocto-bsp create 


通过 调用 yocto-bsp create<bsp-name> <karch> 来 创建 板 支 持 包 ， 其 中 ， 蔡 换 <bsp-name> 为 你 的 板 支 持 包 的 名 字 (不 市 meta-) , Bik 
<karch> 为 希望 的 内 核 架构 。 子 命令 接受 一 些 可 选 参数 : 

- -0<outdir> 或 者 --outdir<outdir> : 如 果 不 带 这 个 参数 ， 那 么 工具 在 当前 目录 以 名 字 <bsp-name> 创 建 板 支持 包 。 为 了 在 不 同 的 目录 创建 它 ， 使 
用 -o 或 者 --outfile 选 项 。 不 幸 的 是 ， 如 果 使 用 这 些 选项 之 一 ， 那 么 你 必须 提供 板 支 持 包 的 完整 路 径 而 不 仅仅 是 基础 路 径 ， 因 为 在 那个 情况 下 ， 工 具 不 使 用 


<bsp-hame>。 


- -i<properties-file > &k4--infile<properties-file>: 这 些 参数 导致 工具 从 文件 中 读 取 用 于 各 种 属性 的 设置 而 不 是 交互 式 地 询问 它们 。 文 件 必须 是 
JSON 格 式 。 


-ccodedump 或 者 --codedump: 转 存 代码 到 文件 bspgen.out 而 不 是 运行 板 支 持 包 创建 。 如 果 你 想 知 道 工 具 通 过 做 什么 来 创建 板 支持 包 而 不 实际 创 
建 它 ， 那 么 使 用 这 个 选项 。 


-5S 或 者 -skip-git-check: 这 些 参数 检查 到 远程 Git 仓 库 的 访问 。 提 供 这 个 选项 以 在 创建 板 支持 包 时 节省 少量 时 间 。 
在 10.4.2 小 节 ， 我 们 将 浏览 一 志 板 支持 包 的 生成 。 
yocto-kernel 工 具 


yocto-kernel 工 具 提 供用 于 对 板 支 持 包 的 内 核 菜 谱 列 出 、 增 加 、 去 除 配置 设置 、 特 性 和 补丁 的 功能 性 。 它 交互 式 地 创建 第 9 草 中 讨论 的 内 核 配 置 片 
段 、 特 性 和 补丁 集合 。 和 yocto-bsp 类 似 ，yocto-kernel 工 具有 你 可 以 通过 --help 选 项 打印 出 的 子 命令 列表 : 


S yocto-kernel --help 
Usage: 
Modify and list Yocto BSP kernel config items and patches. 


usage: yocto-kernel [--version] [--help] COMMAND [ARGS] 
Current 'yocto-kernel' commands are: 


config list List the modifiable set of bare kernel config options 
for a BSP 

config add Add or modify bare kernel config options for a BSP 

config rm Remove bare kernel config options from a BSP 

patch list List the patches associated with a BSP 

patch add Patch the Yocto kernel for a BSP 

patch rm Remove patches from a BSP 

feature list List the features used by a BSP 

feature add Have a BSP use a feature 

feature rm Have a BSP stop using a feature 

features list List the features available to BSPs 

feature describe Describe a particular feature 

feature create Create a new BSP-local feature 


feature destroy Remove a BSP-local feature 


See 'yocto-kernel help COMMAND' for more information on a specific 
command. 


Options: 
--version show program's version number and exit 
-h, --help show this help message and exit 
-D, --debug output debug information 


为 了 使 用 yocto-kernel 工 具 ， 你 必须 已 经 引用 了 你 的 构建 环境 。 然 后 从 构建 环境 内 执行 命令 。 大 部 分 子 命令 将 板 支 持 包 的 名 字 作为 参数 。 这 个 板 支 
持 包 必须 被 包含 在 你 的 构建 环境 的 conf/bblayers.conf 的 BBLAYERS 变 量 
管理 Linux 内 核 配 置 选 项 
config 子 命令 允许 内 核 配置 选项 的 简单 管理 : 
- yocto-kernel config list<bsp>: 列 出 用 于 被 板 支持 包 <bsp> 使 用 的 Linux 内 核 的 所 有 配置 片段 。 
- yocto-kernel config add<bsp>CONFIG <parameter>=[y|n|m]: 增加 修改 内 核 配 置 选项 <parameter> 的 配置 片段 : 


ay (yes) : 开启 参数 。 


-n (no) : 关闭 参数 。 

-m (module) : 构建 内 核 模 块 〈 仅 对 内 核 模块 适用 ) 。 

- yocto-kernel config rm<bsp>CONFIG <parameter>: 去 除 用 于 内 核 配 置 选 项 <parametet> 的 配置 片段 。 
对 config add 和 config rm 子 命令 ， 你 可 以 提供 多 个 配置 项 。 

管理 内 核 补丁 

你 可 以 使 用 patch 子 命令 来 管理 用 于 你 的 板 支 持 包 的 补丁 : 

- yocto-kernel patch list<bsp>: 列 出 所 有 用 于 被 板 支持 包 <bsp> 使 用 的 Linux 内 核 的 补丁 。 


- yocto-kernel patch add<bsp>/path/to/patchfile.patch: 把 补丁 patchfile.patch 从 已 提供 的 路 径 复制 到 板 支持 包 层 <bsp> 内 的 trecipes- 


kernel/linux/files 中 ， 并 且 增 加 它 到 内 核 菜 谱 的 SRC_URI。 


- yocto-kernel patch rm<bsp>patchfile.patch: 把 补丁 patchfile.patch 从 板 支持 包 <bsp> 内 的 recipes-kernel/linux/files 中 去 除 ， 并 且 把 它 从 内 核 菜 谱 


的 SRC_URI 去 除 。 
你 可 以 一 次 对 patch add 和 patch rm 子 命令 提供 多 个 补丁 。 
管理 内 核 特性 
类 似 于 内 核 配 置 选 项 和 补丁 ， 你 可 以 通过 feature 子 命令 来 管理 特性 : 


- yocto-kernel features list<bsp>: 列 出 所 有 本 地 可 用 于 板 支持 包 <bsp> 的 内 核 特性 。 这 些 是 以 .scc 结 尾 的 位 于 recipes-kernel/linux/files 中 的 板 支持 
包 内 的 特性 文件 。 


- yocto-kernel feature list<bsp>: 列 出 所 有 当前 被 板 支持 包 <bsp> 所 使 用 的 内 核 特性 。 


- yocto-kernel feature create<bsp>featurefile.scc"Feature Description"/capabilities CONFI parameter= 
[yIn|m]/path/to/patchfile.patch: 为 板 支持 包 <bsp> 创 建 名 为 featurefile.scc、 使 用 "Feature Description" 作 为 描述 的 新 的 本 地 特性 ， 并 且 增 加 列 在 
capabilities 之 后 的 内 核 配 置 和 参数 和 补丁 。 


- yocto-kernel feature add<bsp>featurefile.scc: 增加 本 地 特性 featurefile.scc 到 板 支 持 包 <bsp> 的 内 核 特性 列表 中 。 特 性 必须 是 以 前 用 yocto-kernel 


feature cteat 创 建 的 。 


- yocto-kernel feature rm<bsp>: 从 板 支持 包 <bsp> 内 核 特 性 列表 中 去 除 一 个 或 者 多 个 特性 。 工 具 列 出 特性 ， 然 后 提示 要 被 去 除 的 特性 。 这 个 命 
令 不 从 板 支持 包 中 删除 特性 ， 仅 仅 从 内 核 的 特性 包含 列表 中 去 除 。 


- yocto-kernel feature destroy<bsp>featurefile.scc: 从 板 支持 包 <bsp> 特 性 的 本 地 列表 中 删除 特性 。 这 个 命令 不 从 板 支持 包 中 删除 特性 文件 、 
配置 片段 和 补丁 。 


feature 子 命令 是 管理 包含 在 内 核 中 的 特性 的 便利 方法 ， 它 不 用 修改 特性 文件 和 菜谱 的 SRC_URI。 


10.4.2 ”用 Yocto 板 支持 包工 具 创 建 板 支 持 包 


现在 是 时 候 把 这 些 结合 起 来 并 使 用 Yocto 项 目 板 支 持 包 工具 来 创建 一 个 基本 的 板 支 持 包 了 。 我 们 的 板 支 持 包 用 于 信息 膏 设 备 。 设 备 使 用 Intel Core i7 
CPU， 有 板 载 HDMI 图 形 输 出 ， 并 且 被 连接 到 多 点 触 控 的 角 摸 屏 以 提供 民 好 的 用 户 体 验 。 作 为 用 于 我 们 设备 的 测试 平台 ， 我 们 使 用 MinnowBoard Max 
并 且 让 它 连 接 市 HDMI1I 和 USB 输 入 的 多 点 触 控 触摸 屏 。 我 们 也 希望 启动 时 板 支 持 包 在 内 核 日 志 中 以 一 个 条 目 来 识别 自己 。 为 了 那个 目的 ,我们 开发 了 简单 
的 设备 驱动 ， 本 质 上 它 是 和 显示 在 第 9 章程 序 清单 9-3 中 的 那个 完全 一 样 。 我 们 仪 仪 把 消息 文本 改 成 了 “Yocto Project Book Kiosk BSP: 
init” 和 “Yocto Project Book BSP: exit.”。 简 单 地 遵循 9.2 节 的 步骤 来 创建 补丁 。 


以 下 步骤 简要 概述 了 创建 你 的 板 支 持 包 (我们 称 其 为 ypbkiosk) 的 工作 流 : 


1. 初 始 化 构建 环境 。 为 了 用 Yocto 项 目 板 支 持 包 工具 创建 板 支 持 包 ， 你 需要 构建 环境 : 


S source /path/to/poky/oe-init-build-env kiosk 


在 conf/local.conf 中 ， 设 置 构建 环境 变量 DL_DIR 和 SSTATE_DIR。 


2. 创 建 板 广 持 包 层 。 为 了 简单 性 ， 我 们 在 构建 环境 内 创建 了 新 的 板 广 持 包 层 。 命 令 


9 yocto-bsp create ypbkiosk x86_64 


启动 交互 式 过 程 来 为 具有 x86_64 架 构 的 机 器 ypbkiosk 创 建 名 为 ypbkiosk 的 板 支 持 包 层 。 该 工具 现在 问 一 些 关 于 我 们 希望 用 在 板 支 持 包 中 的 特性 的 间 


- Would you like to use the default (3.19) kend (y/n) Motule yly 
- Do you need a new machine branch for this BSP (the alternative is to re-use an existing branch) ? (y/n) [default: y]n 
- Please choose a machine branch to base this BSP on: [default: standard/common-pc-64/base]7 (或 者 回 车 以 用 上 默认) 
- Do you need SMP support? (y/n) [default: y]y 〈 或 者 回 车 以 用 默认 ) 
- Which machine tuning would you like to use?[default: tune_core2]2 (Corei7 调 优 ) 
- Do you need support for X? (y/n) [default: yly (或 者 回 车 以 用 默认) 
- Please select an xserver for this machine: [default: xserver_i915]4 (fbdev xserver 4 4} ) 
- Does your BSP have a touchscreen? (y/n) [default: nly 
- Does your BSP have a keyboard? (y/n) [default: yly (或 者 回 车 以 用 默认 ) 
在 你 回答 了 最 后 一 个 问题 后 ， 板 支持 包工 具 设置 板 支持 包 并 且 以 消息 “New x86_64 BSP created in meta-ypbkiosk” ith. 


3. 局 用 触摸 屏 驱 动 。 对 于 我 们 的 襄 板 支持 包 ， 需 要 在 Linux 内 核 中 启用 多 点 触 控 驱动 。 驱 动 的 配置 设置 是 CONFIG _HID_MULTITOUCH。 我 们 使 用 
Yocto 项 目 内 核 工 具 来 增加 局 用 驱动 的 配置 片段 : 


S yocto-kernel config add ypbkiosk 
CONFIG HID MULTITOUCH=y 
Added item: 

CONFIG _HID_MULTITOUCH=y 


工具 添加 设置 到 位 于 meta-ypbkiosk/recipes-kernel/linux/files 中 的 ypbkiosk-user-config.cfg.。 
4. 增 加 板 支 持 包 补丁 。 作 为 一 个 特性 来 增加 板 支 持 包 驱动 补丁 。 特 性 应 用 补丁 ， 也 增加 配置 设置 以 启用 补丁 : 


S yocto-kernel feature create ypbkiosk ypbbspmsg.scc \ 

"Yocto Project Book BSP Message" capabilities \ 

CONFIG_YP_DRIVER=y 0001-Yocto-Project-Book-Kiosk-BSP-Message.patch 
Added feature: 

features/ypbbspmsg.scc 

9 yocto-kernel feature add ypbkiosk features/ypbbspmsg.scc 
Added features: 

features/ypbbspmsg.scc 


第 一 个 命令 yocto-kernel feature create, 创建 特性 并 且 增 加 它 到 板 支 持 包 。 然 而 ， 它 还 没 被 内 核 构 建 所 包含 ， 这 是 由 第 二 个 命令 yocto-kernel 
feature add 来 实现 的 。 


5. 构 建 镜像 。 既 然 我 们 已 经 创建 了 具有 希望 的 内 核 配置 的 板 文 持 包 ， 那 么 我 开始 构建 镜像 


S bitbake -k core-image-sato 


我 们 正在 使 用 core-image-sato 镜 像 目 标 ， 它 提供 我 们 用 于 测试 的 图 形 用 户 界 面 。 


6. 复 制 镜像 到 可 局 动 介质 。 我 们 正在 使 用 MinnowBoard Max 作 为 用 于 亭 的 测试 目标 系统 。 板 从 USB 内 存 棒 中 局 动 。 复 制 镜像 到 内 存 棒 中 


S dd if=tmp/deploy/images/ypbkiosk/core-image-sato-ypbkiosk.hddimg \ 


of=/dev/<usbstickdevice> 


你 需要 蔡 换 <usbstickdevice> 为 设备 节点 的 名 字 ， 把 USB 棒 插入 进 你 的 开发 系统 后 ， 你 可 以 使 用 dmesg 命 令 来 找到 设备 节点 的 名 字 。 


7. 局 动 目标 。MinnowBoard Max 有 一 个 带 shell 的 UEFI BIOS。 在 你 把 USB 内 存 棒 插入 板 中 并 且 开 机 后 ，MinnowBoard Max 启 动 shell。 内 存 棒 上 
的 文件 系统 被 识别 成 fsS0。 在 shell 提 示 上 ， 输 入 fs0:， 在 下 一 个 提示 上 ， 输 入 bootx64。 然 后 ，MinnowBoard Max 应 该 启动 到 Sato 用 户 界面 。 如 果 你 把 


触摸 屏 连 接 到 了 你 的 板 上 ， 那 么 应 该 能 够 使 用 它 了 。 你 也 可 以 打开 终端 并 查找 板 支 持 包 消息 。 


Yocto 项 目 板 支 持 包 的 这 两 个 工具 yocto-bsp 和 yocto-kernel 提 供 了 创建 板 支 持 包 层 的 简单 直接 的 方法 。 仪 仪 几 个 交互 步骤 ， 
制 板 支持 包 。 使 用 yocto-kernel 工 具 管 理 内 核 配 置 选 项 、 补 丁 和 特性 成 为 简单 任 


它们 融 为 一 个 基本 的 板 


支持 包 设置 了 具有 必要 目录 和 文件 的 核心 框架 ， 然 后， 你 可 以 进一步 定 


务 。 不 需要 手动 修改 菜谱 和 其 他 文件 。 


10.5 WAC 
如 果 你 检查 我 们 在 前 面部 分 创建 的 机 器 配置 文件 ypbkiosk.conf， 那 么 注意 下 面 两 行 


DEFAULTTUNE = "corei7-64" 
require conf/machine/include/tune-corei7.inc 


第 一 行 选择 CPU 架 构 和 被 构建 系统 使 用 的 应 用 程序 二 进 制 接口 (Application Binary Interface, ABI) 调谐 (tune) 。 第 二 行为 特定 的 调谐 提供 细 


节 的 工具 链 设 置 ， 例 如 GCC 编译 器 标志 。 
通过 这 样 做 ， 你 当然 无 法 


你 或 许可 以 对 一 个 使 用 更 新 一 代 架 构 的 CPU 使 用 用 于 更 旧版 本 架构 的 调谐 。 但 是 ，i 


这 种 CPU 架构 代 的 层级 结构 是 由 调 优 文件 的 层级 结构 反映 的 。 对 于 lntel x86 架 构 ， 它 尤其 明显 : 
谐 。 基 于 tune- 


CPU 架构 提供 向 后 兼容 性 ， 这 意味 着 ， 
从 更 新 架构 代 的 扩展 指令 集 和 功能 性 中 获 益 。 


tune-corei/.inc: 用 于 带 64 位 扩展 和 MMX、SSE、SSE2、SSE3、SSSE3、SSE4.1 以 及 SSE4.2 指 令 集 支持 的 Intel Core i7 CPU 代 的 调 


cote2 。 


tune-core2.inc: 用 于 带 64 位 扩展 和 MMX、SSE、SSE2、SSE3 和 SSSE3 指 


令 集 支持 的 Ihtel Core2 CPU 代 的 调谐 。 基 于 tune-5806。 


- tune-i586.inc: 启用 Inteli586 特 定 处 理 器 优化 的 调谐 。 基 于 atch-x86 。 


. arch-x86: 用 于 Intel x8632 位 、x8664 位 和 x32 架 构 的 核心 架构 定义 。 
你 可 以 在 OQpenEmbedded 核 心 元 数据 层 meta 的 conf/machine 目 录 和 子 目 录 以 及 子 目 录 的 子 目录 等 找到 调谐 文件 。 


DEFAULT TUNE 变 量 为 特定 CPU 架构 选择 TUNE_FEATURES。 构 建 系统 使 用 DEFAULT_ TUNE 和 TUNE_FEATURES 来 判断 用 于 以 下 的 设置 : 
- TUNE ARCH: 用 于 特定 CPU 架 构 的 GNU 工 具 链 的 权威 架构 。TUNE_ARCH 与 TARGET_ARCH 紧 窗 联 系 ， 因 为 BitBake 配 置 文件 


(meta/conf/bitbake.conf) 赋予 TARGET_ARCH="${TUNE_ARCHY}" 


"TUNE _PKGARCH: 打包 系统 所 已 知 的 用 来 定义 正确 的 架构 、 应 用 程序 二 进 制 接口 和 输出 包 的 调 优 的 包 架 构 。 


- TUNE _ASARGS: 用 于 特定 调 优 架 构 的 汇编 程序 标志 。 


. TUNE_CCARGS: 用 于 特定 调 优 架构 的 编译 器 标志 。 


JUNE_LDARGO>: 用 于 特定 调 优 架构 的 链接 器 标志 。 


构建 系统 验证 调 优 设置 的 兼容 性 ， 特 别 是 冲突 的 应 用 程序 二 进 制 接口 设置 。 


每 个 调谐 被 加 到 由 变量 AVAILTUNES 代 表 的 可 用 调谐 列表 中 。 你 可 以 使 用 以 下 命令 来 获取 用 于 你 当前 设置 的 列表 : 
$ bitbake -e | grep AVAILTUNES 


例如 ， 通 过 由 我 们 的 ypbkioks.conf 机 器 配置 提供 的 设置 ， 你 将 看 到 : 


$ bitbake -e | grep AVAILTUNES 

# SAVAILTUNES [10 operations] 

AVAILTUNES=" x86 x86-64 x86-64-x32 1586 core2-32 core2-64 core2-64-x32 \ 
core17-32 corei7-64 corei7-64-x32" 


在 细节 上 : 
- X86: 带 有 32 位 应 用 程序 二 进 制 接 口 的 Intel x8632 位 架构 
- X86-86: 带 有 64 位 应 用 程序 二 进 制 接 口 的 Intel x8664 位 架构 
- X86-64-x32: 带 有 32 位 应 用 程序 二 进 制 接口 的 Intel x8664 位 架构 
. 1586: 带 有 32 位 应 用 程序 二 进 制 接 口 的 Inteli58632 位 架构 
- core2-32: 带 有 32 位 应 用 程序 二 进 制 接口 的 Intel Core232 位 架构 
- core2-64: 带 有 64 位 应 用 程序 二 进 制 接 口 的 Intel Core264 位 架构 
- core2-64-x32: 带 有 32 位 应 用 程序 二 进 制 接口 的 Intel Core264 位 架构 
. corei7-32: 带 有 32 位 应 用 程序 二 进 制 接口 的 Intel Core i732 位 架构 
- CoOrel7-64: 带 有 64 位 应 用 程序 二 进 制 接口 的 Intel Core i764 位 架构 
- CoOrel7-64-X32: 带 有 32 位 应 用 程序 二 进 制 接口 的 Intel Core i764 位 架构 


用 于 其 他 CPU 架 构 的 调谐 提供 用 于 CPU 架 构 和 应 用 程序 二 进 制 接口 的 类 似 配置 。 


10.6 创建 可 局 动 介 质 镜像 


由 OpenEmbedded 构 建 系统 创建 的 镜像 不 总 是 能 够 被 直接 用 在 存储 介质 上 来 创建 可 启动 的 系统 。 在 我 们 为 BeagleBone 创 建 第 一 个 镜像 时 ， 我 们 看 
到 了 那样 的 情况 。 用 于 分 区 和 格式 化 SD 卡 然后 复制 文件 和 镜像 到 各 种 分 区 的 额外 步骤 是 必要 的 。 其 他 镜像 依赖 于 目标 平台 以 及 使 用 的 存储 硬件 和 介质 。 
相对 于 HDD，SD 可 能 需要 一 个 不 同 的 镜像 格式 。 为 了 促进 创建 可 以 被 直接 传输 到 存储 介质 的 可 启动 镜像 的 过 程 ，OpenEmbedded 构 建 系统 提供 了 
OpenEmbedded 镜 像 创 建 器 (wic) M 


wic 工 具 从 由 构建 系统 创建 的 制品 中 创建 可 启动 镜像 。 为 了 使 wic 命 令 正确 工作 ， 必 须 从 构建 系统 的 上 下 文中 运行 它 ， 正 如 以 往 ， 这 是 通过 oe-init- 
build-env 引 用 来 完成 的 。 


wic 使 用 以 .wks 结 尾 的 kickstart 广 件 ， 这 些 文件 命令 工具 创建 什么 镜像 以 及 如 何 创建 忌 们 。 构 建 系统 目 市 一 组 kickstart 文 件 。 为 了 获得 内 置 镜像 的 列 
表 ， 使 用 以 下 命令 : 


9 wic list images 


Wic 被 设计 成 是 可 扩展 的 。wic kickstart AT CSR RAY STIR, wichtttt+@awicAs hrs TAS. AS a) Aaa 
件 ， 使 用 以 下 命令 : 


S wic list source-plugins 


当 我 们 更 仔细 地 看 kickstart 文 件 的 时 候 ， 我 们 展示 kickstart 文 件 和 源 插件 如 何 一 起 工作 。 

wic 有 两 个 操作 模式 : 

- 原始 模式 (Raw Mode) : 你 必须 在 wic 命 令 行 上 指定 kickstart 文 件 需 要 的 参数 。 

` RERI (Cooked Mode) : wic 使 用 你 构建 环境 的 当前 MACHINE 设 置 来 决定 选项 。 
原始 模式 提供 更 好 的 灵活 性 并 且 给 了 你 对 镜像 创建 过 程 更 多 的 控制 ， 而 毫 制 模式 更 易于 使 用 。 这 两 种 模式 本 质 上 是 以 相同 方式 调用 的 : 

S wic create <kickstart_file> [options] 
选项 决定 了 wic 是 否 运 行 在 原始 模式 或 者 就 制 模 式 。 在 接 下 来 的 两 个 部 分 ， 我们 会 解释 这 两 种 模式 以 及 对 每 个 模式 你 可 以 使 用 什么 选项 。 如 果 你 正 是 
使 用 由 wic list images 显 示 的 列表 中 的 kickstart 文 件 ， 那 么 你 不 要 提供 .wks 后 绥 。 


在 你 可 以 使 用 wic 之 前 ， 你 需要 使 用 构建 系统 为 你 的 开 上 友 主 机 构建 几 个 工具 : 
9 bitbake parted-native dosfstools-native mtools-native 


你 不 需要 以 root 运 行 wic。 实 际 上 ， 你 不 应 该 以 root 运 行 wic。wic 不 写 任何 存储 介质 一 一 它 为 存储 介质 创建 镜像 ， 然 后 你 可 以 复制 镜像 到 存储 介质 


L 


[1 你 可 能 要 问 ， 为 什么 工具 被 命名 为 wic 而 不 是 oeic (OpenEmbedded Image Creator) 。 党 试 快速 说 出 二 合 元 音 oeic， 你 将 注意 到 它 听 起 来 更 像 wic。 


10.6.1 用 吝 制 模式 创建 镜像 
在 训 制 模式 中 ， 只 有 两 个 参数 是 用 wic 创 建 镜 像 所 需要 的 : 
$ wic create <kickstart_file> -e <image_target> [options] 


其 中 ， 

<kickstart_file> 是 OpenEmbedded kickstart 文 件 。 你 可 以 使 用 由 wic 提 供 的 预 录 的 kickstart 文 件 ， 或 者 你 可 以 提供 你 自己 的 。 

- <image_target> 是 构建 系统 镜像 目标 的 名 字 ， 例 如 core-image-base 或 者 core-image-sato 或 者 任何 你 自己 的 镜像 名 字 。 
总 的 来 说 ， 所 有 其 他 设置 是 由 wic 从 构建 环境 决定 的 ， 特 别 是 conf/local.conf 中 的 MACHINE 设 置 。 
在 就 制 模式 下 ， 这 些 额外 的 选项 是 可 用 的 : 

. -O PATH, --outdir=PATH: 到 最 终 镜像 位 置 的 路 径 。 

. -c COMPRESSOR, --compress-with=COMPRESSOR: 用 来 压缩 最 终 镜像 的 压缩 实用 程序 。wic 支 持 gzip、bzip2 和 xz 作 为 COMPRESSOR。 
--f IMAGE, --build-rootfs=IMAGE: 在 创建 介质 镜像 之 前 ， 使 用 BitBake IMAGE 来 构建 根 文 件 系统 镜像 。 

--D, --debug: 显示 关于 创建 过 程 的 详细 的 调试 信息 。 它 显示 精确 的 命令 序列 并 且 帮 助 故障 排除 问题 。 


--s, --Skip-build-check: 略 过 构建 检查 步 又， 它 是 用 于 验证 构建 环境 是 否 已 经 被 正确 引用 了 的 简单 的 健全 性 检查 器 (sanity checker) 。 


例如 ， 


S wic create bootimg-efi -e core-image-base 


创建 用 扩展 固件 接口 (Extended Firmware Interface, EFl) BIOS 启 动 的 镜像 ， 它 可 以 被 直接 传输 到 可 启动 介质 。 


一 个 合理 的 警告 : 仅 仪 因为 你 可 以 通过 wic 使 用 kickstar 文 件 来 创建 镜像 并 不 意味 着 这 个 镜像 将 在 你 的 目标 系统 上 启动 。 你 需要 保证 ， 你 选择 了 匹配 
你 目标 系统 的 正确 的 kickstart 文 件 。 如 果 在 前 面 的 例子 中 机 器 配置 是 MACHINE="beaglebone"， 那 么 wic 将 确实 创建 带 有 用 于 扩展 固件 接口 的 启动 分 区 
的 镜像 。 然 而 ， 它 将 不 会 在 BeagleBone 板 上 启动 ， 因 为 BeagleBone 没 有 扩展 固件 接口 BIOS。 


10.6.2 用 原始 模式 @ 建 镜像 


当 以 原始 模式 使 用 wic 时 ， 你 必须 在 命令 行 上 提供 必要 的 参数 : 


S wic create <kickstart_file> [options] 


其 中 ，<kickstart file> 是 OpenEmbedded kickstart 文 件 ， 它 可 以 是 由 wic 提 供 的 kickstart 文 件 之 一 或 者 是 你 自己 创建 的 。 选 项 如 下 : 

. -r ROOTFSDIR, --rootfs-dir=ROOTFSDIR: 在 开发 主机 上 到 用 于 目标 的 根 文 件 系统 的 路 径 。 

--b BOOTIMGDIR, --bootimg-dir=BOOTIMGDIR: 到 引导 加 载 程序 制品 (例如 扩展 固件 接口 和 syslinux 目 录 或 者 U-Boot 文 件 ) 的 路 径 。 
--k KERNELDIR, --kernel-dir=KERNEL DIR: 到 Linux 内 核 的 路 径 。 


--n NATIVE SYSROOT, --native-sysroot=NATIVE SYSROOT: 到 例如 parted、DOS 文 件 系 统 工具 等 原生 工具 的 路 径 。 这 些 可 以 是 由 
OpenEmbedded 构 建 系 统 构 建 的 工具 或 者 由 你 的 开发 主机 提供 的 工具 。 


. -0 PATH, --outdir=PATH: 到 最 终 镜像 位 置 的 路 径 。 

. -c COMPRESSOR, --compress-with=COMPRESSOR: 用 来 压缩 最 终 镜 像 的 压缩 实用 程序 。wic 支 持 gzip、bzip2 和 xz 作为 COMPRESSOR。 
--f IMAGE, --build-rootfs=IMAGE: 在 创建 介质 镜像 之 前 ， 使 用 BitBake IMAGE 来 构建 根 文件 系 统 镜像 。 

--D, --debug: 显示 关于 创建 过 程 的 详细 调试 信息 。 它 显示 精确 的 命令 序列 并 且 帮 助 故 障 排除 问题 。 

在 其 最 简单 的 形式 下 ， 如 果 你 必须 以 原始 模式 调用 wic， 那 么 如 下 : 


$ wic create bootimg-efi -r <ROOTFSDIR> -b <BOOTIMGDIR> -k <KERNELDIR> 


该 示例 假设 你 已 经 在 开发 主机 上 安装 了 文件 系统 工具 。 

当 使 用 毫 制 模式 并 带 有 -e<image target> 选 项 时 ，wic 通 过 运行 bitbake-e<image target> 来 自动 地 从 构建 环境 决定 各 种 选项 
--r, --rootfs-dir: IMAGE ROOTFS 

--k, --kernel-dir: STAGING_KERNEL_DIR 

--n, --native-sysroot: STAGING_DIR_NATIVE 

--b, --bootimg-dir: 249; 用 于 各 种 引导 加 载 程序 的 源 播 件 需要 决定 这 个 


除非 你 正在 使 用 -f (--build-rootfs) 选项 ， 否 则 在 原始 模式 下 ， 你 不 需要 引用 构建 环境 。 


10.6.3 kickstart 文 件 


正如 我 们 看 到 的 ,命令 


S wic list images 


提供 了 可 用 kickstart 文 件 的 列表 。 实 际 的 kickstart 文 件 位 于 poky/scripts/lib/wic/canned-wks。 
程序 清单 10-4 显 示 了 一 个 kickstart 文 件 ， 它 用 于 为 适合 于 BeagleBone 的 SD 卡 创建 带 有 一 个 vfat 启 动 分 区 和 一 个 ext4 文 件 系统 分 区 的 镜像 。 
程序 清单 10-4 ”SD 卡 镜像 (sdimage-bootpart.wks) 


# short-description: Create SD card image with a boot partition 
# long-description: Creates a partitioned SD card image. Boot files 
# are located in the first vfat partition. 


part /boot --source bootimg-partition --ondisk mmcblk --fstype=vfat 
--label boot --active --align 4 --size 16 

part / --source rootfs --ondisk mmcblk --fstype=ext4 --label root 
--align 4 


partis Sismwicbhli2—_tak, B-TEAM ENKE AXA kickstart LFR, /bot f AAN Kazim, /BIRD KATES. 
source 人 参数 指定 用 来 创建 分 区 的 源 插 件 ，bootimg-partition 用 于 局 动 分 区 ，rootfs 用 于 根 文 件 系统 分 区 。 剩 余 的 参数 决定 分 区 特征 ， 我 们 稍 后 将 详细 解 
释 他 们 。 


程序 清单 10-5 显 示 了 一 个 为 启动 带 有 老式 PC BIOS 的 系统 创建 镜像 的 kickstart 文 件 。 


程序 清单 10-5 ”老式 PC BIOS 程 序 清单 镜像 (directdisk.wks) 


# short-description: Create a 'pcbios' direct disk image 
# long-description: Creates a partitioned legacy BIOS disk image that the 
# user can directly dd to boot media. 


part /boot --source bootimg-pcbios --ondisk sda --label boot -active \ 
--align 1024 

part / --source rootfs --ondisk sda --fstype=ext4 --label platform \ 
--align 1024 


bootloader --timeout=0 --append="rootwait rootfstype=ext4 \ 
video=vesafb vga=0x318 console=tty0" 


在 这 个 例子 中 ， 启 动 分 区 使 用 源 插 件 bootimg-pcbios， 它 创建 一 个 Syslinux 启 动 分 区 。bootloader 指 令 指 示 Syslinux 立 即 启动 内 核 (-- 
timeout=0) 并 上 且 传递 由 append 指 定 的 参数 到 Linux 内 核 。 


程序 清单 10-6 显 示 了 一 个 kickstart 文 件 ， 它 为 启动 一 个 市 有 扩展 固件 接口 BIOS 的 系统 创建 镜像 。 


程序 清单 10-6 ”扩展 固件 接口 BIOS 启 动 镜像 (mkefidisk.wks) 


# short-description: Create an EFI disk image 
# long-description: Creates a partitioned EFI disk image that the user 
# can directly dd to boot media. 


part /boot --source bootimg-efi --sourceparams="loader=grub-efi" \ 
--ondisk sda --label msdos --active --align 1024 


part / --source rootfs --ondisk sda --fstype=ext4 --label platform \ 
--align 1024 


part swap --ondisk sda --size 44 --label swapl --fstype=swap 
bootloader --timeout=10 --append="rootwait rootfstype=ext4 \ 


console=ttyPCH0,115200 console=tty0 vmalloc=256MB \ 
snd-hda-intel.enable_msi=0" 


在 这 个 例子 中 ， 启 动 分 区 是 使 用 bootimg-efi 源 插件 来 创建 的 ， 其 他 使 用 扩展 固件 接口 Grub 引导 加 载 程序 。 除 了 启动 和 根 文 件 系统 分 区 ， 还 有 一 个 
交换 分 区 被 创建 。bootloader 指 令 指示 Grub 在 局 动 Linux 内 核 前 等 待 10 秒 (timeout=10) 并 且 传 递 由 append 指 定 的 参数 到 Linux 内 核 。 


10.6.4 kickstart 文 件 指令 


要 么 从 头 开 始 ， 要 么 通过 复制 一 个 预 录 的 文件 ， 你 可 以 很 容易 地 创建 自己 的 kickstart 文 件 。 如 果 你 在 目录 poky/scriptsVlib/wic/canned-wks 中 创建 
自己 的 kickstart 文 件 ， 那 么 对 于 wic 来 说 它们 是 已 知 的 ， 并 上 且 你 不 需要 提供 路 径 和 后 级。 缺点 是 ， 你 正在 修改 构建 系统 源 ， 这 使 得 更 新 更 加 困难 了 一 点 。 
kickstart 文 件 当前 只 包含 两 个 指令 : partition 和 bootloader。 每 个 指令 都 接受 一 个 预定 义 集合 的 参数 。 提 供 功 能 性 的 源 插件 需要 理解 参数 。 


分 区 指令 
分 区 指令 part 在 介质 上 创建 分 区 。 格 式 如 下 : 
Part <mountpoint> <options> 


<mountpoint> 决 定 分 区 被 挂 载 到 哪里 。 它 可 以 是 如 下 之 一 : 





-/path: 分 区 挂 载 点 路 径 例如 /、/ustr、/opt 和 /home 等 。 
‘swap: 分 区 是 一 修 交 拨 分 区 。 


<options> 提 供 关 于 如 何 创 建 分 区 的 必要 信息 : 


` --SOUrCe: 决定 用 来 填充 分 区 的 数据 源 。 如 果 你 不 使 用 这 个 选项 ，wic 创 建 空 分 区 ， 并 且 你 必须 至 少 提供 --size。 如 果 你 希望 wic 用 文件 系统 来 格式 
化 分 区 ， 那 么 你 需要 提供 --fstype。 


如 果 你 使 用 --source rootfs，wic 创 建 一 个 根 文件 系统 分 区 ， 其 具有 足够 空间 用 于 由 -r (--rootfs-dir) 参数 提供 的 根 文 件 系统 。 


---SiIZe@: 以 MB 为 单位 的 最 小 的 分 区 大 小 。 如 果 你 不 使 用 --source， 那 么 你 必须 提供 这 个 参数 。 如 果 你 想 创建 比 由 根 文 件 系 统 内 容 (也 参见 --extra- 


space 和 --overhead-factor) 所 决定 的 分 区 更 大 的 分 区 ， 那 么 你 可 以 和 --soutce 一 起 提供 这 个 参数 。 
---ondisk: 在 特定 的 设备 上 创建 分 区 。 
- --ondrive: 与 --ondisk 相 同 。 
---fstype: 用 于 格式 化 分 区 的 文件 系统 类 型 。 被 支持 的 文件 系统 类 型 是 ext2、ext3、ext4、btrfs、squashfs 和 swap。 
---fsoptions: 将 被 写 到 /etc/tstab 的 选项 字符 串 。 字 符 串 需要 被 包 在 引号 中 。 如 果 你 不 指定 这 个 参数 ， 那 么 它 被 设置 成 "defaults"。 
---label: 分 区 标签 。 
---active: 把 分 区 标记 为 启动 分 区 。 
---align: 在 一 个 nh KB 边界 上 开始 分 区 。 
---no-table: 创建 、 格 式 化 并 且 填 充分 区 但 不 增加 它 到 分 区 表 。 
---extra-space: 增加 额外 的 空间 (以 MB 为 单位 ) 到 分 区 。 默 认 值 是 10MB。 


- --OVerhead-factor: 成 倍 放 大 分 区 大 小 ， 分 区 大 小 要 么 是 由 --size 提 供 的 要 么 是 从 由 -tf (--tootfs-dir) 指定 的 根 文件 系统 目录 内 容 决 定 的 ， 然 后 乘 以 


这 个 因子 sa 默认 值 是 1.3。 
---part-type: 为 分 区 类 型 指定 全 局 唯一 标识 符 (Globally Unique Identifier, GUID) 以 用 于 GUID 分 区 表 (GPT) H, 
---use-uuid: 为 分 区 生成 随机 Linux UUID。 
---uuid: 为 分 区 指定 Linux UUID。 

bootloader 指 令 


bootloader 指 令 提供 用 于 引导 加 载 程序 的 配置 : 


bootloader --timeout=<timeout_in_seconds> --append="<kernel_parameters> 


中 令 仪 仅 接 受 两 个 参数 : 
---timeout: 在 引导 加 载 程序 启动 默认 选项 前 等 待 的 时 间 (以 s 为 单位 ) 。 这 个 参数 被 用 在 向 用 户 展 示 局 动 选项 列表 的 引导 加 载 程序 上 。 
---append: 包 在 引号 中 、 被 传递 到 Linux 内 核 的 参数 字符 串 。 


[1] 为 获取 关于 GPT 的 信息 ， 见 https://wiki.atchlinux.org/index.php/GUID_Patrtition_Table 和 


https://en.wikipedia.org/wiki/ GUID_Partition_Table#Pattition_type_GUIDs。 


10.6.5 ”插件 
插件 为 wic 功 能 性 提供 简单 扩展 性 ， 它 们 是 用 Python 编写 的 。 当 前 ， 有 两 类 插件 : 镜像 器 (imager) 和 源 。 你 可 以 在 目录 
poky/scripts/lib/wic/plugins 中 找到 插件 。 每 个 插件 都 有 自己 的 子 目录 。 


镜像 器 插件 安装 整个 系统 到 一 个 文件 ， 该 文件 包含 一 个 分 区 表 和 一 个 或 者 多 个 用 文件 系统 格式 化 的 分 区 。 镜 像 器 的 输出 是 一 个 可 直接 传输 到 介质 的 
文件 。 所 有 镜像 器 插件 继承 自 ImagerPlugin Python 类 。 当 地 仪 有 一 个 镜像 器 插件 一 一 DirectPlugin， 它 用 于 创建 所 有 镜像 。 


源 插件 从 特定 源 创建 特定 类 型 的 分 区 。 它 们 被 用 在 kickstart 文 件 的 part 指 令 中 。 源 插件 继承 自 SourcePlugin Python 类 。 
文件 poky/scripts/lib/wic/pluginbase.py 定 义 核心 插件 类 |magerPlugin 和 SourcePlugin。 


当前 ， 用 户 扩展 仅仅 限于 源 揪 件 。 为 了 创建 你 自己 的 源 播 件 ， 写 一 个 包含 插件 类 的 Python 源 文件 。 你 可 以 把 文件 放 进 目录 
poky/scripts/lib/wic/plugins/source 中 ,或 者 你 可 以 把 它 放 进 在 目录 meta-mylayer/scripts/lib/wic/plugins/source 中 的 你 自己 的 层 内 。 层 的 根 目 录 下 
的 精确 路 径 是 重要 的 ; 否则 ，wic 不 能 定位 到 插件 。 


为 了 编写 你 自己 的 源 插 件 ， 你 从 基 源 插件 类 SourcePlugin 衍 生 它 并 且 实 现 执行 任务 的 函数 ， 如 程序 清单 10-7 所 示 。 
程序 清单 10-7 ” 源 插 件 


class MyPartitionPlugin(SourcePlugin): 
name = 'mypartition' 


@classmethod 
def do_prepare_partiton(cls, part, ...) 


@classmethod 
def do_configure_partition(cls, part, ...) 


@classmethod 
def do_install_disk(cls, part, ...) 


@classmethod 
def do_stage_partition(cls, part, ...) 


你 自己 的 源 插件 总 是 必须 设置 hame 属 性 为 唯一 名 字 。 这 是 源 插件 为 wic 所 知 的 名 字 。 它 是 你 使 用 part 指 令 的 --source 参 数 的 名 字 ， 例 如 : 

part / --source mypartition <options> 

依赖 于 你 的 源 插件 ， 你 需要 实现 一 个 或 者 多 个 方法 ，wic 将 在 分 区 创建 过 程 的 各 个 阶段 调用 这 个 或 者 这 些 方法 : 
do_configure_partition(): 在 do_ptepate_pattition0 之 前 被 调用 ， 并 用 于 为 分 区 创建 配置 文件 ， 例 如 引导 加 载 程序 配置 文件 。 


- do stage partition(): 在 do_prepare_pattition0 之 前 被 调用 ， 并 用 于 剪裁 由 源 提供 的 分 区 内 容 。 


-do_prepare_partition): 被 调用 来 填充 内 容 进 分 区 。 这 个 方法 创建 分 区 镜像 ， 然 后 该 分 区 镜像 被 集成 进 硬盘 镜像 。 
- do_install_disk(): 在 do_prepare_patrtition0) 之 后 并 且 在 分 区 集成 进 最 终 硬盘 镜像 之 前 ， 如 果 额 外 的 步骤 需要 执行 ， 那 么 它 被 调用 。 


源 插件 至 少 实现 do_prepare_partition0 方 法 ， 因 为 它 就 是 实际 从 内 容 源 rootfs-dir、kernel-dir 和 bootimg-dir 中 填充 分 区 内 容 的 方法 。 这 些 参数 的 
值 被 传 到 方法 以 便 插 件 可 以 访 间 各 上 自 目 录 。 如 果 你 的 源 插件 不 实现 一 个 特定 方法 ， 那 么 作为 替代 ， 超 类 方法 被 使 用 。 对 这 4 个 方法 ， 超 类 方法 不 做 任何 事 
只 记录 调试 消息 。 


10.6.6 ”传输 镜像 


在 Wic 完 成 了 镜像 的 创建 后 ， 你 可 以 简单 地 传输 它 到 SD 卡 或 者 USB 棒 或 者 任何 你 为 其 构建 镜像 的 其 他 介质 上 : 
S sudo dd if=<image_file> of=/dev/<device> 


wic 在 创建 了 镜像 后 ， 它 提供 你 镜像 的 名 字 和 和 位置。 默认 情况 下 ， 输 出 目录 是 /var/tmp/wic/build。 


因为 你 正在 把 镜像 文件 直接 写 入 到 设备 ， 所 以 你 必须 以 root 权 限 执行 命令 。 这 可 能 是 危险 的 ， 因 为 指定 了 错误 的 设备 会 擦 除开 友 主 机 上 的 设备 和 分 
区 。 忆 是 要 两 次 确认 ， 你 正在 使 用 正确 的 设备 名 。 在 插入 了 介质 后 立即 使 用 dmesg 来 找 正确 的 设备 名 忆 是 一 个 好 主意 。 


10.7 Bs 


Yocto 项 目 板 支持 包 提 供 调 整 层 来 用 相同 的 核心 构建 系统 支持 很 多 不 同 的 硬件 平台 。 

. 不 像 传 统 的 散 入 式 设 备 板 支持 包 ，Yocto 项 目 板 支持 包 不 是 独立 的 。 它 们 需要 OpenEmbedded 核 心 以 及 可 能 的 其 他 元 数据 层 。 
- Yocto 项 目 板 支持 包 不 包含 工具 链 或 者 开发 工具 。 这 些 是 由 核心 层 提 供 的 。 

. Yocto 项 目 板 支 持 包 是 BitBake 层 ， 其 通过 增加 它们 的 路 径 到 构建 环境 的 conf/bblayets.conf 文 件 的 BBLAYERS 变 量 中 而 包含 在 构建 环境 中 。 
.Yocto 项 目 板 支持 包 必 须 定 义 至 少 一 个 提供 目标 平台 特定 设置 的 机 器 配置 文件 。 

Yocto 项 目 板 支 持 包 可 能 增加 它 自己 的 菜谱 或 追加 来 自 其 他 层 的 菜谱 以 按照 目标 硬件 的 需求 调整 包 的 构建 。 

- Yocto 项 目 板 支 持 包 可 以 简单 地 互相 交换 而 不 涉及 除 构建 环境 的 conf/local.conf 文 件 中 的 MACHINE 变 量 以 外 的 配置 设置 。 

* 因为 Yocto 项 目 板 支持 包 仅 仅 包 含 对 构建 系统 的 目标 特定 调整 ， 所 以 维护 被 极 大 地 缩减 了 。 

Yocto 项 目 板 支持 包 遵 循 特定 布局 。 

- yocto-bsp 工 具 允 许 一 个 基本 板 支持 包 的 快速 创建 ， 该 板 支持 包 遵 从 板 支持 包 惯 例 。 

` yocto-kernel 工 具 简 化 了 Linux 内 核 配 置 选 项 、 补 丁 和 特性 的 管理 。 


- OpenEmbedded 镜 像 创建 器 (wic) 极 大 地 简化 了 可 启动 镜像 的 创建 ， 该 镜像 可 直接 传输 到 各 种 介质 。wic 可 通过 kickstatrt 文 件 和 源 插件 而 被 扩展 。 


10.8 ”参考 文献 


Yocto 项 目 板 支 持 包 开发 者 指南 ,， www.yoctoproject.org/docs/1.8/bsp-guide/bsp-guide.html, 


lle WAAR 


在 前 面 的 章节 中 ， 我 们 学 习 了 如 何 使 用 Yocto 项 目 来 构建 Linux 操 作 系统 镜像 、 如 何 定 制 那些 镜像 以 及 如 何 通过 板 文 持 包 来 调整 它们 以 适应 特定 硬 
件 。 由 硬件 、 操 作 系 统 栈 和 一 堆 其 他 开源 软件 组 成 的 设备 不 是 一 个 产品 。 最 终 ， 你 希望 为 设备 开发 自己 的 提供 最 终 用 户 功能 性 的 软件 包 ， 构 建 它 们 并 且 
部 署 它 们 到 设备 。 对 于 这 样 的 任务 来 讽 ， 你 需要 用 于 你 目标 系统 的 软件 开 友 环境 ， 它 通 剃 在 应 用 程序 开 友 工具 包 (ADT) 或 者 软件 开 友 工具 包 (SDK) 
中 被 找到 。Yocto 项 目 使 用 这 两 者 ， 并 且 通 常 把 已 经 被 ADT 安 六 程序 (来 自从 Web 服 务 器 提取 的 包 仓库 ) 安 半 的 ADT 叫 作 SDK， 把 已 经 被 构建 系统 创建 
的 SDK 叫 作 SDK。 实 际 的 工具 包 提供 相同 的 功能 性 ， 因 为 用 于 ADT 的 包 仓 库 前 面 已 经 被 构建 系统 创建 。 


使 用 Yocto 项 目 构建 系统 ， 你 可 以 构建 匹配 你 的 目标 系统 本 身 的 应 用 程序 开发 工具 包 。 然 后 你 可 以 使 用 ADT 环 境 来 为 你 的 设备 开发 和 构建 应 用 。 


在 本 章 中 ， 我 们 研究 Yocto 项 目 ADT 是 由 什么 组 成 的 以 及 你 可 以 如 何 构建 和 使 用 它 。 


11.2 izesYoctoIMHADT 


你 可 以 以 多 种 方式 设置 ADT : 


- 下 载 ADT 安 装 程序 : 从 Yocto 项 目下 载 站 点 目下 载 ADT 安 装 程序 taf 包 ， 解 压 它 ， 配 置 它 用 于 你 的 目标 ， 然 后 运行 它 。 接 着 ，ADT 安 装 程序 从 Yocto 
项 目下 载 站 点 下 载 合适 的 交叉 工具 链 、 根 文件 系统 等 ， 并 且 在 你 的 开发 系统 上 安装 它们 。 这 个 方法 对 于 设置 ADT 来 说 是 最 方便 的 ， 但 是 它 使 用 预 创建 的 
系统 根 镜 像 ， 很 大 可 能 不 匹配 你 的 目标 镜像 。 


- 构建 ADT 安 六 程序 : 使 用 Yocto 项 目 构建 环境 自己 构建 ADT 安 装 程序 而 不 是 下 载 它 。 在 那 之 后 ， 它 与 下 载 ADT 安 装 程序 就 完全 相同 了 。 


. 构建 工具 链 安装 程序 来 创建 ADT: 使 用 你 的 目标 构建 环境 ， 创 建 包 含 交 叉 工 具 链 和 目标 系统 根 的 工具 链 安 装 程序 ， 该 安装 程序 完全 匹配 你 的 目标 
系统 并 且 具 有 用 于 你 可 能 已 经 增加 到 定制 镜像 中 的 软件 包 的 开发 包 。 


前 两 种 方法 已 经 由 Yocto 项 目 应 用 开发 者 指南 (“详细 解释 了 。 在 本 章 中 ， 我 们 聚焦 在 第 3 种 方法 上 ， 使 用 构建 环境 为 目标 创建 工具 链 安装 程序 。 


[1] http://downloads.yoctoptroject.org/releases/yocto/yocto-2.0/adt-installer。 


[2] www.yoctoproject.org/ docs/1.8/adt-manual/adt-manual.html。 


11.2.1 构建 工具 链 安装 程序 

如 果 你 已 经 有 了 用 于 你 目标 系统 的 构建 环境 ， 可 能 包含 板 支 持 包 和 其 他 层 ， 那 么 你 可 以 使 用 它 来 构建 带 有 你 增加 到 定制 根 文件 系统 镜像 中 的 全 部 软 
件 组 件 的 工具 链 安 装 程序 。 对 我 们 的 例子 来 襄 ， 我 们 正在 使 用 来 自前 一 章 用 于 膏 项 目的 构建 环境 和 板 支 持 包 层 。 

我 们 的 板 支 持 包 层 meta-ypbkiosk 当 前 不 包含 定制 镜像 目标 。 程 序 清单 11-1 显 示 了 用 于 它 的 镜像 菜谱 。 


程序 清单 11-1 定制 镜像 菜谱 (ypbkiosk-image-sato.bb) 


DESCRIPTION = "Custom image for the Yocto book Kiosk, which is based \ 
on core-inmage-sato. We only replaced the Dropbear SSH \ 
server with the OpenSSH server, which is necessary for \ 
the ADT, and added tar.bz2 to the image types built." 


IMAGE FEATURES += "splash package-management xll-base \ 
xll-sato ssh-server-openssh hwcodecs" 


LICENSE = "MIT" 
inherit core-image 
IMAGE INSTALL += "packagegroup-core-xll-sato-games" 


IMAGE_FSTYPES += "tar.bz2" 


在 meta-ypbkiosk 层 内 创建 目录 recipes-core/images， 并 且 向 其 增加 程序 清单 11-1 中 的 菜谱 文件 ypbkiosk-image-sato.bb。 


现在 ， 在 引用 了 构建 环境 后 ， 通 过 执行 以 下 命令 来 构建 工具 链 : 
S bitbake -c populate_sdk ypbkiosk-image-sato 


也 要 确保 你 构建 环境 的 conf/local.conf 中 的 MACHINE 变 量 被 设置 成 MACHINE="ypbkiosk"。 构 建 系 统 从 这 个 变量 获取 用 于 工具 链 的 正确 的 架构 设 
B. 


populate_sdk 适 用 于 所 有 镜像 目标 ， 并 且 为 镜像 目标 创建 工具 链 ， 它 把 类 似 MACHINE 和 EXTRA_IMAGE _FEATURES 等 的 所 有 其 他 设置 考虑 在 内 。 
一 旦 任务 完成 ， 它 把 工具 链 安装 程序 放 在 构建 环境 的 tmp/deploy/sdk 中 。 工 具 链 安装 程序 是 以 .sh 结尾 的 单一 可 执行 文件 。 它 部 分 是 shell 脚 本 安装 程 
序 ， 部 分 是 包含 在 主机 和 目标 系统 根 中 的 实际 工具 链 的 有 效 载 倚 。 如 果 你 打开 文件 看 它 的 内 容 ， 那 么 你 会 发 现 文本 MARKER:， 它 把 脚本 和 有 效 载 位 分 
开 。 


除了 万 便 分 友 ， 这 个 单一 文件 配置 的 目的 是 使 得 工具 链 完全 上 自 包含 ， 意 味 着 所 有 二 进 制 都 被 连接 到 它们 自己 的 libc 副 本 ,这 导致 不 依赖 于 主机 系统 。 
因为 在 构建 时 ， 工 具 链 的 安 六 路 径 是 不 可 知 的 (你 可 能 安 六 它 在 你 系统 中 的 任何 地 方 ) ， 并 且 到 动态 加 载 器 的 指针 不 能 被 动态 地 调整 ， 所 以 ，shell 脚 本 
部 分 处 理 重 定位 。 


用 于 工具 链 为 其 构建 的 开发 主机 的 架构 是 由 配置 变量 SDKMACHINE 决 定 的 。 在 创建 工具 链 安 沪 程序 的 时 候 ， 这 个 变量 被 自动 设置 成 构建 系统 正在 运 
行 于 其 中 的 主机 的 架构 。 如 果 你 希望 为 不 同 的 开发 主机 架构 构建 工具 链 ， 而 不 是 为 了 你 正 用 来 构建 工具 链 的 这 个 东西 ， 那 么 你 可 以 显 式 地 设置 你 构建 环 
境 的 conf/local.conf 中 的 SDKMACHINE 变 量 。 当 前 被 支持 用 于 构建 的 架构 只 有 i686 (x8632 位 ) 和 x86 64 (x8664 位 ) 。 


11.2.2 Re TER 


现在 ， 工 具 链 的 安装 是 相当 简单 的 : 

9 cd tmp/deploy/sdk 

S ./poky-glibc-x86_64-ypbkiosk-image-sato-corei7-64-toolchain-2.0.sh 

实际 工具 链 安装 程序 文件 可 能 依赖 于 你 的 设置 。 工 具 链 安装 程序 默认 安装 工具 链 到 /opt/poky/<version> 目 录 。 如 果 你 希望 的 话 ， 那 么 你 可 以 提供 
不 同 的 目录 。 


工具 链 安装 程序 的 一 个 特性 是 ， 你 可 以 为 具有 任何 架构 的 任何 机 器 创建 不 同 的 安装 程序 ， 并 且 把 它们 安装 到 相同 的 目录 。 构 建 系统 对 每 个 架构 仅仅 
创建 一 组 cross-canadian 工 具 链 二 进 制 中 并 且 工 具 链 安装 程序 分 离 目标 系统 根 到 不 同 的 目录 中 。 这 是 有 可 能 的 ， 因 为 描述 目标 硬件 的 细节 可 以 作为 选项 
被 传 到 编译 器 。 那 些 选 项 是 由 环境 脚本 通过 赋值 例如 CC、LD 等 的 变量 来 设置 的 。 


程序 清单 11-2 显 示 了 用 tree-L 3 获得 的 工具 链 安装 目录 的 布局 。 


程序 清单 11-2 工具 链 安 装 目 录 布 局 


/opt/poky/2.0 

—-— environment-setup-corei7-64-poky-linux 

—-— environment-setup-cortexa8hf-vfp-neon-poky-1linux-gnueabi 
|- site-config-corei7-64-poky-linux 

-~ site-config-cortexa8hf-vfp-neon-poky-1linux-gnueabi 

L— sysroots 

L— corei7-64-poky-linux 


| 

| | -— bin 

| | -— boot 
| | -— dev 

| | -— etc 

| | -— home 
| | | 一 lib 

| | -— media 
| | -— mnt 

| | | proc 
| | -— run 

| | -— sbin 
| | > sys 

| | į tmp 

| | -— usr 

| | L— var 

| —-— cortexa8hf-vfp-neon-poky-linux-gnueabi 
| | -— bin 

| | -— boot 
| | -— dev 

| | -— etc 

| | -— home 
| | | 一 lib 

| | -— media 
| | | 一 mnt 

| | “Droc 
| | = run 

| | | 一 sbin 
| | | 一 sys 

| “| H= tmp 

| | Ur 

| | L— var 

| L— x86_64-pokysdk-linux 
| | 一 etc 

| | 一 lib 

| -— sbin 
| -— usr 

| L— var 


—-— version-corei7-64-poky-linux 
L— version-cortexa8hf-vfp-neon-poky-linux-gnueabi 
文件 和 子 目录 可 以 被 分 类 成 以 下 几 部 分 : 


- 环境 设置 : environment-setup-* 脚 本 设置 用 于 各 种 架构 的 工具 链 配 置 。 如 果 你 希望 使 用 特定 的 工具 链 ， 那 么 你 需要 引用 各 自 脚本 ， 类 似 于 在 设置 
Yocto 构 建 环境 时 引用 oe-init-build-env 脚 本 。 


. 申 点 配置 : 在 使 用 GNU Autotools 开 发 软件 包 时 ， 站 点 配置 文件 site-config* 包 含 配置 设置 。 


系统 根 : systoots 子 目录 包含 一 个 带 有 用 于 每 个 目标 架构 和 主机 架构 的 系统 根 的 子 目 录 。 例 如 ， 子 目录 x86_64-pokysdk-linux 是 用 于 主机 的 系统 根 ， 
它 包 含 交 叉 工 具 链 。 另 外 ， 该 示例 也 包含 用 于 MinnowBoatd Max 的 Intel Core 这 的 目标 系统 根 和 用 于 BeagleBone 的 ARM Cortex A8 的 目标 系统 根 。 


. 版 本 文件 : version-* 文 件 包含 关于 工具 链 版 本 的 版 本 信息 。 


关于 构建 工具 链 安 装 程序 的 最 后 一 点 说 明 : 默认 情况 下 ， 创 建 的 工具 链 仪 仪 构建 动态 连接 的 二 进 制 。 如 果 你 希望 构建 静态 连接 的 二 进 制 ， 那 么 你 需 
要 保证 在 你 的 系统 根 中 能 找到 那个 包含 有 静态 库 的 包 。 你 可 以 通过 增加 这 些 包 到 IMAGE _ INSTALL 变量 来 实现 这 个 目的 。 这 个 例子 增加 glibc 静 态 库 : 


IMAGE _ INSTALL append = " glibc-static" 


添加 这 一 行 到 conf/local.conf， 并 且 增 加 任何 你 需要 的 其 他 静态 库 。 
[1] Cross-canadian 意 味 着 ， 在 由 HOST_ARCH 定 义 的 架构 上 运行 的 构建 系统 创建 运行 在 由 SDKMACHINE 定 义 的 架构 上 的 工具 链 ， 它 还 可 以 为 运行 在 由 
TARGET ARCH 定义 的 架构 上 的 系统 构建 软件 。 这 可 能 涉及 3 个 不 同 的 架构 。 然 而 ， 最 常见 的 是 ，SDKMACHINE 和 HOST _ARCH 是 相同 的 。 
Proxy Error 


The proxy server received an invalid response from an upstream server. 
The proxy server could not handle the request GET /resource/readBook. 


Reason: Error reading from remote server 


11.2.4 目标 上 执行 


如 果 你 有 一 个 MinnowBoard Max， 并 且 它 具有 我 们 在 前 面 章节 中 构建 的 Linux 操 作 系 统 栈 ， 那 么 复制 二 进 制 到 目标 。 你 可 以 通过 内 存 棒 来 完成 或 者 
通过 网 络 使 用 scp: 


S scp fibonacci root@<target_ip>:/usr/bin/fibonacci 


蔡 换 <target ip> 为 你 的 MinnowBoard Max IP 地 址 。 现 在 你 可 以 在 目标 上 通过 目标 的 控制 台 或 者 ssh 连 接 来 执行 程序 : 


S ssh root@<target_ip> 

root@ypbkiosk:~# fibonacci 

Enter the number of terms: 10 

First 10 terms of the Fibonacci series are: 
0 

1 


root@ypbkiosk: ~# 


11.2.5 ”远程 目标 上 调试 


作为 软件 开 上 友 者 ， 改 障 排除 和 修复 缺陷 是 你 的 生计 。 首 选 的 工具 是 这 样 一 个 调试 器 一 一 它 让 你 控制 和 检查 运行 程序 的 状态 以 及 在 程序 朋 溃 之 后 分 析 
它 ， 这 通常 被 称 为 事后 总 结 调试 (post-mortem debugging) 。Yocto 项 目 提供 了 GDB[ 作为 一 个 用 于 目标 的 包 以 及 作为 一 个 用 于 开发 主机 的 带 有 交叉 
版 本 的 包 。 像 任何 交叉 开发 工具 ， 交 叉 调试 器 运行 在 使 用 一 个 架构 的 开 友 主机 上 ， 而 同时 能 够 调试 被 编译 成 用 于 另 一 个 架构 的 主机 上 的 二 进 制 、 可 执行 
程序 以 及 库 。 


通过 在 conf/local.conf 的 变量 EXTRA IMAGE FEATURES 中 包含 tools-debug， 我 们 已 经 包含 了 目标 包 。 交 叉 版 本 被 自动 包含 在 SDK 中 。 

你 可 以 直接 使 用 如 下 命令 来 在 目标 上 运行 GDB: 

root@ypbkiosk:~# gdb /usr/bin/fibonacci 

GDB 启 动 ， 开 始 我 们 的 斐 波 那 契 程序 ， 并 且 停 在 第 一 个 指令 上 。 从 这 里 ， 你 可 以 使 用 GDB 命 令 来 控制 执行 中 的 程序 (在 GDB 术 语 中 被 称 为 下 标 
(inferior) ) 、 展 示 程 序 变量 等 。 


然而 ， 直 接 在 目标 上 调试 并 不 总 是 可 能 的 。 具 有 内 存 和 硬盘 限制 的 目标 可 能 不 能 存储 和 加 载 被 处 理 的 二 进 制 或 者 程序 的 调试 信息 。 而 且 ，GDB 需 要 
定位 和 处 理 例如 函数 和 变量 名 、 变 量 值 以 及 栈 追踪 等 信息 ， 这 要 求 你 在 目标 上 使 用 包含 调试 信息 的 可 执行 文件 ， 这 也 常 被 叫做 非 精简 二 进 制 (non- 
stripped binary) 。 另 外 ， 为 了 能 够 于 调试 时 在 GDB 内 检查 程序 的 源 代码 ， 你 需要 复制 程序 的 所 有 源 文件 到 目标 上 。 对 于 简单 到 如 我 们 的 斐 波 那 契 例子 


一 样 的 程序 ， 那 是 简单 和 直接 的 ， 但 是 对 于 从 很 多 不 同 源 文件 中 构建 的 程序 ， 它 可 能 变 得 相当 笨重 。 

为 了 突破 这 些 限制 ， 你 可 以 用 gdbserver 来 远程 调试 。gdbserver 不 是 调试 器 而 是 运行 在 目标 上 并 且 控 制 被 调试 的 程序 或 者 下 标的 服务 器 进程 。 
gdbserver 不 加 载 和 处 理 任 何 与 被 调试 的 程序 相关 的 调试 信息 而 是 中 继 所 有 信息 到 运行 于 开发 主机 上 的 GDB。 在 开发 主机 上 的 GDB 发 送 控制 命令 到 目标 
GDB 来 完成 的 ， 所 以 在 目标 上 仪 仪 需要 具有 调试 符号 二 进 制 。 


如 果 你 希望 调试 用 在 你 程序 中 的 库 ， 那 么 需要 通过 在 你 目标 镜像 的 IMAGE _ INSTALL 变量 中 包含 这 些 库 的 调试 包 来 把 它们 安装 在 目标 上 。 按 照 惯例 ， 
所 有 调试 包 以 -dbg 结 尾 。 如 果 你 希望 包含 由 你 的 目标 镜像 安装 的 所 有 包 的 调试 包 ， 你 可 以 向 conf/local.conf 中 的 EXTRA IMAGE FEATURES 增 加 dbg- 
pkgs。 


如 果 你 确实 包含 所 有 包 的 调试 包 ， 那 么 注意 ， 你 的 目标 根 文 件 系 统 镜像 的 大 小 将 明显 增加 ， 因 为 源 文件 是 *-dbg 包 的 组 成 部 分 。 通 过 设置 你 构建 环境 
的 conf/local.conf 文 件 的 PACKAGE DEBUG SPLIT STYLE 变量 为 debug-without-src， 你 可 以 命令 构建 系统 不 把 源 文件 包含 进 调试 包 中 。 因 为 这 个 变 
量 全 局 性 地 控制 所 有 包 的 打包 行为 ， 所 以 它 将 导致 整个 目标 系统 的 重新 构建 。 


因为 在 开 友 主机 上 的 GDB 负 责 加 载 和 处 理 所 有 调试 信息 ， 所 以 它 必 须 对 非 精 简 二 进 制 〈 用 -9 选项 并 且 不 市 任何 优化 而 编译 的 可 执行 文件 和 所 有 库 ) 
拥有 访问 。 在 目标 上 的 二 进 制 可 以 是 精简 的 ， 但 是 不 能 市 优化 编译 。 


GDB 和 gdbserver 使 用 基于 网 络 或 者 (替代 性 地 ) 串 行 连接 的 命令 行 接口 互相 通信 。 你 首先 在 目标 上 启动 gdbserver 和 被 调试 的 程序 ， 然 后 你 开发 主 
机 上 启动 GDB， 命 令 GDB 连 接 到 你 目标 上 的 gdbserver。 


在 目标 上 启动 gdbserver 


为 了 远程 调试 ， 你 需要 把 gdbserver 安 装 在 你 的 目标 上 。 你 可 以 直接 在 你 的 目标 镜像 中 安装 gdbserver， 但 是 使 用 tools-debug 镜 像 特性 是 更 加 便利 
的 四。 

直接 在 控制 台中 或 者 通过 安全 Shell 来 在 你 的 目标 上 启动 gdbserver。 例 如 ， 对 于 我 们 的 斐 波 那 契 程序 ， 使 用 以 下 命令 : 

root@ypbkiosk:~# gdbserver localhost:2345 /usr/bin/fibonacci 


Process /usr/bin/fibonacci created; pid = 810 
Listening on port 2345 


gdbserver 直 到 被 调试 的 进程 终止 才 退 出 。 端 口 2345 是 用 于 GDB 和 gdbserver 的 默认 端口 。 如 果 你 希望 ， 那 么 你 可 以 修改 端口 。 


在 开发 主机 上 启动 GDB 


为 了 调试 在 你 目标 上 运行 着 的 进程 ， 你 需要 启动 交叉 调试 器 并 且 命 令 它 连 接 到 你 目标 上 的 gdbserver。 从 你 已 经 构建 了 斐 波 那 契 应 用 的 目录 内 ， 正 如 
在 11.2.3 小 节 中 做 的 那样 引用 环境 设置 脚本 ， 然 后 启动 调试 器 : 

S source environment-setup-corei7-64-poky-linux 

S$ ${GDB} fibonacci 

GNU gdb (GDB) 7.9.1 


Reading symbols from fibonacci. ..done. 
(gdb) 


为 了 清晰 ， 我 们 省 略 了 GDB 的 一 些 初始 输出 。 在 完成 了 初始 化 后 ，GDB 展 示 它 的 命令 行 提 示 (gdb) 。 命 令 GDB 连 接 到 目标 上 的 gdbserver: 


(gdb) target remote <target_ip>:2345 
Remote debugging using <target_ip>:2345 


(gdb) 
把 <target ip> 蔡 换 成 你 目标 系统 的 IP 地 址 。 如 果 你 为 gdbserver 指 定 了 不 同 的 端口 ， 那 么 你 必须 在 此 处 指定 相同 的 端口 。 在 你 的 目标 系统 上 ， 应 该 
看 到 gdbserver 响 应 连接 : 


Remote debugging from host <host_ip> 
现在 可 以 在 开 友 主机 上 开始 你 的 调试 会 话 了 。 输 入 continue 将 在 你 的 目标 上 运行 程序 。 当 目标 上 的 下 标 进程 终止 后 ， 在 目标 上 运行 着 的 gdbserver 
也 将 终止 。 然 而 ， 你 开发 主机 上 的 GDB 将 继续 运行 。 你 可 以 重 局 目标 上 的 gdbserver， 然 后 重新 连接 GDB。 


除非 你 是 一 个 兢 固 的 命令 行 开 友 者 ， 否 则 使 用 GDB 和 它 的 命令 行 可 能 不 是 你 的 菜 。 有 很 多 可 用 于 GDB 的 图 形 前 端 。 其 中 一 个 是 由 GNU 项 目 提 供 的 可 


靠 的 数据 显示 调试 器 (Data Display Debugger, DDD) Bl。，DDD 可 以 用 任何 Linux 发 行 版 的 包 管理 系统 来 轻松 安装 。DDD 有 基本 但 是 可 用 的 用 户 界面 
而 不 带 任何 虚 饰 ， 如 图 11-1 所 示 。 


# B B Di ‘runt | Lelie rstreit/ YoctoU Ve y Ore CS :vpbooRTDoNnaccl/ftibonacclc wo A Be 








#1include*stdio.h? 
int maing) 


int n, first = 0, second = 1, next, c; 














orintfC"Enter the number of terms: "J; 
scant ("%d" ,&n); 


printfc"First %d terms of Fibonacci series are:\n".n); 


2i (c=0; c<n; cH) 


if tc <= 1) 
next = c: 
else 


next = first + second: 
first = second: 
second = next: 


printf Sdn" next): 


Breakpoint 1, main C) at fibonacei.¢:12 
(gdb) graph display n 

(gdb) graph display ¢ dependent on 1 
(gdb) next 

(gdb) : 


图 11-1 DDDAF Re 


DDD 默 认 使 用 安 妆 人 在 你 开发 系统 上 的 主机 GDB。 你 可 以 命令 DDD 使 用 来 目 Yocto 项 目 SDK 的 交叉 调试 器 : 


$ source environment-setup-corei7-64-poky-linux 
S ddd --debugger ${GDB} 


DDD 不 提供 用 来 连接 到 远程 gdbserver 的 按钮 或 者 菜单 项 。 你 必须 同位 于 DDD 底 部 的 GDB 命 令 窗口 手动 输入 target remote 命 令 。 
Eclipse 1DE 也 提供 了 用 于 GDB 的 非常 友好 的 图 形 前 端 。 在 11.4 节 中 ， 我 们 将 解释 如 何 把 Eclipse 和 Yocto 项 目 以 及 调试 器 的 使 用 集成 起 来 。 
调试 标准 库 


如 果 你 希望 用 GDB 追 踪 安 装 在 你 目标 上 的 标准 库 ， 那 么 你 需要 告诉 GDB 在 哪里 找到 调试 信息 以 及 用 于 库 的 源 文件 。SDK 在 你 的 开发 主机 上 安装 用 于 
目标 平台 的 所 有 调试 包 ， 包 括 在 SDK 系 统 根 内 的 源 文件 一 一 例如 ，/opt/poky/2.0/sysroots/corei7-64-poky-linux 是 用 于 我 们 的 MinnowBoard Max 的 
SDK, 


你 可 以 通过 输入 以 下 内 容 来 命令 GDB 使 用 一 个 系统 根 : 
(gdb) set sysroot /opt/poky/2.0/sysroots/corei7-64-poky-linux 


(gdb) set substitute-path /usr/src/debug \ 
/opt/poky/2.0/sysroots/corei7-64-poky-linux/usr/src/debug 


然后 ，GDB 将 使 用 这 个 系统 根来 寻找 调试 信息 和 源 文件 。 当 启动 GDB 时 再 次 重复 输入 这 些 设置 是 相当 单调 乏味 的 。 因 此 ， 你 可 以 增加 语句 
到 .gdbinit 文 件 。 你 可 以 把 这 个 文件 放 在 你 的 家 目录 中 ， 在 这 种 情况 下 设置 将 应 用 到 所 有 项 目 ; 或 者 放 在 项 目 目录 中 ， 在 这 种 情况 下 ， 当 你 从 那个 目录 内 
部 局 动 GDB 时 ， 它 将 仪 应 用 到 当前 的 项 目 。 如 果 你 确实 在 项 目 目录 中 使 用 了 一 个 .gdbinit 文 件 ， 那 么 在 你 的 家 目录 中 ， 你 仍然 需要 一 个 包含 如 下 行 
的 .gdbinit 文 件 : 


set auto-load safe-path / 
set auto-load local-gdbinit on 


GDB AA RS RH INTI MAP RP See, MARE tit SRE RAs. 


[1] https://www.gnu.org/software/edb. 
[2] 我 们 推荐 使 用 tools-debug 而 不 是 直接 安装 gdbsetrvet 包 ， 因 为 它 只 要 求 对 conf/local.conf 的 修改 而 不 是 修改 镜像 菜谱 。 


[3] https://www.gnu.org/software/ddd. 


11.3 ”构建 应 用 


任何 重要 的 应 用 都 可 能 由 很 多 源 文 件 组 成 ， 这 些 源 文 件 被 编译 和 连接 成 库 或 可 执行 程序 文件 。 工 具 链 的 环境 设置 使 得 开发 基于 makefile 和 基于 GNU 
Autotools 的 应 用 相当 简单 。 


11.3.1 基于 makefile 的 应 用 


对 于 基于 makefile 的 项 目 ， 最 好 不 要 在 makefile 中 设置 例如 CC、AS、LD 和 CFLAGS 的 任何 环境 变量 ， 因 为 用 于 那些 变量 的 设置 是 由 用 于 工具 链 环境 
的 初始 化 脚本 确立 的 。 简 言 之 ， 你 不 应 该 直接 设置 或 者 提供 有 关 特 定 染 构 的 工具 链 标志 ， 因 为 它们 可 能 限制 在 不 同 的 架构 上 编译 项 目的 能 力 。 工 具 链 环 
境 以 及 Yocto 项 目 构 建 环境 提供 所 有 架构 依赖 的 设置 。 


程序 清单 11-4 显 示 了 一 个 简单 的 makefile， 用 于 构建 我 们 的 计算 斐 波 那 契 数 列 的 项 目 。 


程序 清单 11-4 ”用 于 著 波 那 掉 数列 项 目的 makefile 


# Makefile for the Fibonacci Application 


# Files 
SOURCES=fibonacci.c 
OBJECTS=S$ (SOURCES: .c=.0) 
EXEC=fibonacci 


# Define extra flags here 
EXTRACFLAGS=-ansi 


all: $ (SOURCES) $ (EXEC) 


$ (EXEC): $(OBJECTS) 
$ (CC) $(CFLAGS) $(EXTRACFLAGS) $(OBJECTS) -o $@ 


$.0 : %.¢ 
$(CC) S$S (CFLAGS) $(EXTRACFLAGS) -c $< 
install: 
install (EXEC) $(DESTDIR) /usr/bin 


clean: 
rm -rf *.0 $(EXEC) 


当然 ， 它 依然 是 一 个 相当 简单 的 项 目 ， 但 是 它 举 例 说 明了 使 用 由 环境 提供 的 变量 和 通过 独立 变量 来 提供 任何 额外 配置 设置 的 概念 。 


11.3.2 ”基于 Autotools 的 应 用 


在 第 8 草 中 ， 我 们 讨论 了 GNU Autotools 和 为 自动 工具 化 的 软件 包 编 写 菜谱 。 工 具 链 环境 提供 用 于 构建 自动 工具 化 的 包 的 所 有 必要 设置 ， 包 括 站 点 
配置 文件 。GNU Autotools 通 过 检测 系统 配置 来 使 得 应 用 可 移植 于 不 同类 UNIX 系 统 。 当 工作 在 交叉 开发 环境 时 ， 那 种 检测 不 能 正常 工作 : Autotools 将 
爹 测 开发 主机 配置 而 不 是 用 于 目标 的 正确 配置 。 向 Autotools 提 供 目 标 配 置 是 站 点 配置 文件 的 目的 。 


为 了 举例 说 明 在 自动 工具 化 项 目 中 使 用 工具 链 的 过 程 ， 我 们 将 构建 GNU Hello 应 用 : 


` 
` 
` 
` 
` 
` 
` 
` 
` 
` 


source environment-setup-corei7-64-poky-linux 

wget http://ftp.gnu.org/gnu/hello/hello-2.10.tar.gz 
tar xvf hello-2.10.tar.gz 

cd hello-2.10 

aclocal ${OECORE_ACLOCAL_OPTS} -I m4 

autoconf 

autoheader 

automake -a 

./configure ${CONFIGURE_FLAGS } 

make 


前 4 个 步骤 是 不 需 解释 的 : 我 们 设置 环境 ， 然 后 下 载 用 于 GNU Hello 应 用 的 源 包 ， 解 压 它 ， 并 且 改 变 到 已 解压 的 源 目录 。 


然后 ， 我 们 运行 aclocal 来 基于 automake 宏 自动 生成 aclocal.m4。 这 些 宏 是 从 由 -| 选项 增加 的 目录 中 收集 的 。OECORE_ACLOCAL OPTS 为 工具 链 
配置 增加 那些 选项 ， 而 -1 m4 包含 源 的 本 地 m4 目录 。 


然后 ， 运 行 autoconf、autoheader 和 automake 创 建 被 configure 使 用 的 配置 输入 、 头 文件 模板 和 makefile 模 块 。 


在 那 之 后 ， 本 地 configure 脚 本 被 执行 来 确定 构建 配置 和 生成 makefile。 环 境 变量 CONFIGURE FLAGS 为 交叉 编译 提供 主机 和 目标 配置 设置 。 


最 后 但 也 很 重要 的 是 ， 运 行 make 构 建 应 用 。 


11.4 Eclipse 集成 


使 用 命令 行 工 具 、 编 辑 器 、 交 叉 工 具 链 、makefile、 脚 本 等 的 开 上 友 长 久 以 来 一 直 是 认 入 陈 开 发 者 的 日 钊 工作 ， 因 为 用 于 肉 入 式 系 统 具有 图 形 用 户 界 
面 的 集成 开 友 环境 (IDE) 的 开 上 友 一 直 沙 后 于 用 于 原生 开 上 友 的 它们 的 同伴 。 工 作 在 用 于 个 人 计算 机 的 操作 系统 的 原生 应 用 的 应 用 开 妈 者 通 冲 有 大 量 不 同 的 
IDE 选 择 用 于 他 们 的 平台 来 最 合适 地 满足 他 们 的 需求 。 启 入 式 开 发 者 必须 一 直 工 作 在 硅 片 三 丙 或 者 第 三 方 工 具 链 公司 为 特定 硬件 和 软件 平台 提供 的 工具 
上 ,在 很 多 情况 下 ， 这 种 工具 并 不 多 。 使 用 Linux 用 于 藤 入 式 系 统 开 友 对 骨 入 式 开 友 者 来 说 已 经 扩大 了 开 友 工具 的 选择 。 


这 些 选 择 之 一 ， 而 不 是 唯一 选择 ， 是 Eclipse。Eclipse 最 初 是 IBM 为 了 Java 开 发 而 开发 的 !1]， 是 可 通过 插件 来 扩展 的 一 种 IDE， 以 服务 很 多 不 同 开发 
目的 ， 并 在 一 个 通用 框架 内 遵循 标准 工作 流 来 集成 各 种 工具 。 在 幕后 ，Equinox 上 是 核心 开放 服务 网 关 协议 (Open Services Gateway 
Initiative, OSGi) DB] 框 架 规格 说 明 的 一 个 实现 ， 它 为 插件 被 安装 和 集成 进 Eclipse 以 及 两 者 互相 通信 提供 管道 系统 。 在 OSGi 术 语 中 ， 播 件 通常 被 称 为 捆 
绑 (bundle) ， 软 件 包 可 以 被 安装 进 OSGi 框 架 中 并 且 向 其 他 捆绑 提供 服务 。 

虽然 最 初 Eclipse 是 作为 用 于 Java 编 程 语言 的 IDE 而 开发 的 ， 但 是 它 已 经 扩展 成 支持 很 多 其 他 编程 语言 了 ， 其 中 有 Ada、C/C++、Cobol、Erlang.、 
Fortran、Haskell、JavaScript、Lua、Perl、PHP、Python、Ruby 和 Scala 等 ; 扩展 成 连接 一 系列 源 代码 控制 管理 ， 例 如 Git、Perforce 和 Subversion 
等 ; 还 扩展 成 与 一 套 正 在 增加 的 工具 集成 。 那 些 插件 之 一 是 Yocto 项 目 插件 ， 它 集成 Yocto 项 目 工具 链 等 。 


[1] 最 初 的 Eclipse 代码 来 自 于 IBM VisualAge IDE. 
[2] www.eclipse.org/equinox. 


[3] www.ospgl.otg。 


11.4.1 Eclipse IDE 


Eclipse 安 凌 包 被 预先 配置 成 用 于 特定 任务 而 发 布 ， 例 如 针对 Java 开 发 者 的 Eclipse IDE， 针 对 Java EE 开发 者 的 Eclipse IDE， 针 对 C/C++ 开发 者 的 
Eclipse 1DE， 以 此 类 推 。 在 Eclipse 下 载 站 点 由， 你 可 以 找到 完整 列表 。 为 了 与 Yocto 项 目 集成 ， 针 对 C/C+ + 开发 者 的 Eclipse 1DE 是 最 佳 选择 ， 因 为 它 已 
经 包含 了 插件 需要 的 核心 组 件 : 

-C/C++F ALA 

- Eclipse Git Team Provider 


` 远程 系统 浏览 器 (Remote System Explorer, RSE) 


Yocto 项 目 Eclipse 持 件 要 求 匹 配 的 Eclipse 版 本 。 对 于 Yocto 项 目 2.0 (Jethro) ， 其 中 插件 可 用 的 Eclipse 版 本 是 Juno、Kepler 和 Luna。 在 Yocto 项 目 
Eclipse 网 站 上 ， 你 总 是 可 以 找到 你 需要 安装 的 Eclipse 的 那个 版 本 加 。 


几乎 所 有 主流 Linux 发 行 版 都 提供 用 于 从 它们 的 包 仓 库 中 安 涂 的 Eclipse。 那 些 可 能 工作 ， 但 是 在 安装 它们 中 的 任何 一 个 之 前 ， 你 需要 验证 用 于 Yocto 


项 目的 匹配 版 本 是 被 提供 的 ， 你 很 大 可 能 需要 独立 安装 上 面 列 出 的 3 个 插件 引 。 如 果 你 的 发 行 版 不 提供 匹配 的 版 本 ， 或 者 你 倾向 于 手动 安装 ， 那 么 你 需要 
使 用 来 自 Eclipse 站 点 的 安装 包 : 


1 .安装 Java: Eclipse 是 Java 应 用 ， 至 少 需要 java 运行 时 环境 (Java Runtime Environment, JRE) 午 来 运行 。Eclipse 可 以 和 OpenJDK 以 及 Oracle 
Java 一 起 工作 。Linux 发 行 版 通常 从 包 仓 库 中 提供 OpenJDK 用 以 安 痊 。 简 单 地 使 用 你 友 行 版 的 包 管理 器 来 安 六 Java 并 且 用 以 下 命令 来 验证 安 六 : 


$ Java -version 

openjdk version "1.8.0 40" 

OpenJDK Runtime Environment (build 1.8.0 40-b25) 
OpenJDK 64-Bit Server VM (build 25.40-b25, mixed mode) 


2.2 Eclipse: 为 你 的 开发 主机 系统 下 载 针 对 C/C++ 开发 者 的 正确 的 Eclipse 1DE 版 本 。 在 我 们 的 例子 中 ， 这 是 eclipse-cpp-luna-SR2-linux-gtk- 
Xx86_64.tar.gz， 它 适用 于 任何 64 位 基于 x86 的 Linux 系 统 。 安 装 包 是 一 个 简单 的 压缩 的 tar 包 ， 你 可 以 解压 它 到 你 系统 内 的 任何 目录 中 (我们 使 用 /opt， 然 
而 ， 这 需要 root 访 问 ) : 


S pa: /opt 
S sudo tar xvf \ 
~/Downloads/eclipse-cpp-luna-SR2-linux-gtk-x86_64.tar.gz 


现在 启动 Eclipse IDE: 
$ /opt/eclipse/eclipse & 


Eclipse 首 先 显 示 一 个 对 话 框 用 以 为 它 的 工作 空间 选择 位 置 。 默 认 ~/workspace 是 合适 的 ， 除 非 你 想 使 用 不 同 的 目录 ，。 


3. 安 妆 标 准 的 Eclipse 插件 : 你 需要 安 濠 几 个 通过 Eclipse 下 载 站 点 提供 的 标准 插件 。 为 了 安 六 那些 插件 ， 首 先 从 Eclipse workbench 的 Help 菜 单 中 选 
择 Install New Softwarehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/...。 然 后 ， 从 Work with: 组 合 框 中 选择 匹配 你 的 Eclipse 版 本 的 下 载 站 点 
(对 Eclipse Lunai, AbsLuna—http://download.eclipse.org/releases/luna) 。 


现在 你 可 以 选择 用 于 安 疼 的 各 种 插件 (如果 任 何以 下 的 项 没 显 示 ， 那 么 它们 已 经 被 安 闻 了 ) : 
a. 展 开 列 表 Mobile Device Development 并 且 选 择 以 下 : 
- C/C++Remote Launch (Requires RSE Remote System Explorer) 
- Remote System Explorer End-user Runtime 
- Remote System Explorer User Actions 
- Target Management Terminal (Core SDK) 
- TCF Remote System Explorer add-in 
- TCF Target Explorer 
b. 展 开 列 表 Linux Tools 并 且 选 择 
- Linux Tools LTTng Tracer Control 
Cc. 展 开 列 表 Programming Languages 并 且 选 择 
- C/C++Autotools Support 
- C/C++Development Tools 
完成 安装 并 重启 Eclipse。 
4. 安 装 Eclipse Yocto 插 件 : 我 们 从 Yocto 项 目下 载 站 点 安装 插件 。 


a. 在 Eclipse 已 经 再 次 启动 后 ， 从 Help 菜 单 中 选择 Install New Softwarehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/...， 然 后 在 Work with: 区 域 单 击 
Addhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/...。 在 Location: 
字段 中 输入 http://downloads.yocto-project.org/releases/eclipse-plugin/2.0/luna， 在 Name: 字段 中 输入 一 个 有 意义 的 名 字 ， 例 如 Yocto Project, 


b. 选 择 以 下 内 容 旁 边 的 复 选 框 : 
* Yocto Project ADT Plug-in 
- Yocto Project BitBake Commander Plug-in 


- Yocto Project Documentation plug-in 


过 接受 许可 协议 完成 安装 ， 并 且 重 局 Eclipse。 


你 的 Eclipse 安 闭 现在 已 经 准备 好 用 于 与 Yocto 项 目 ADT 集 成 。 


[1] www.eclipse.org/downloads o 

[2] https://www.yoctoproject.org/tools-resoutces/projects/eclipse-ide-plug. 

[3] 对 Yocto 项 目 Eclipse 插件 来 说 ，Eclipse Git Team Providet 不 是 严格 必要 的 ， 但 却 是 推荐 的 。 
[4] 当然 ， 你 也 可 以 使 用 包含 JRE 的 Java 开 发 工具 包 (Java Development Kit, JDK) 。 


11.4.2 ”集成 Yocto 项 目 ADT 


现在 ,我 们 正 把 在 11.2 节 中 设置 的 ADT 与 Eclipse 和 Yocto 项 目 Eclipse 插 件 集 成 起 来 。 过 程 被 拆 分 成 以 下 的 步骤 : 
1. 配 置 交叉 工具 链 选项 。 
2. 配 置 目 标 选 项 。 


在 接 下 来 的 步骤 中 你 选择 的 配置 选项 将 成 为 你 用 Yocto 项 目 插件 开 友 的 所 有 项 目的 默认 设置 。 每 个 你 创建 的 新 项 目 会 继承 这 些 设 置 ， 对 每 个 项 目 ， 你 
可 以 稍 后 调整 它们 。 


对 于 下 面部 分 摘 述 的 配置 步骤 来 训 ， 你 首先 需 

1. 从 Window 菜 单 中 选择 Preferences 以 显示 Preferences 对 话 框 。 
2. 从 列表 中 选择 Yocto Project ADT 以 显示 配置 屏幕 。 

配置 屏幕 被 划分 成 以 下 部 分 : 


- Cross-Development Profiles (交叉 开发 配置 文件 ) : 你 可 以 为 Yocto 项 目 ADT 开 发 创建 具有 不 同 设 置 的 多 个 配置 文件 。 名 为 Standard Profile 的 配 
置 文件 是 默认 的 ， 它 被 应 用 到 所 有 新 项 目 ， 除 非 在 创建 项 目 时 你 选择 不 同 的 配置 文件 。 你 不 能 移 除 Standard Profile， 要 保持 选择 为 Standard Profile. 


- Cross Compiler Options (交叉 编译 器 选项 ) : 这 部 分 配置 交叉 工具 链 。 
- Toolchain Type (工具 链 类 型 ) : 你 有 如 下 的 选择 : 


- Standalone Prebuilt Toolchain (独立 预 构建 工具 链 ) : 这 个 选项 是 用 于 已 经 被 提供 了 一 个 预 构建 和 打包 的 Yocto 项 目 工具 链 的 开发 者 ， 他 们 已 经 把 这 
个 工具 链 安 装 在 了 开发 系统 上 。 


- Build System Derived Toolchain (构建 系统 衍生 的 工具 链 ) : 如 果 你 希望 使 用 来 自 Yocto 项 目 构 建 环境 的 工具 链 ， 那 么 使 用 这 个 选项 。 
因为 我 们 用 Yocto 项 目 构 建 了 一 个 工具 链 并 且 把 它 安装 在 了 开 友 系统 上 ， 所 以 选择 第 一 个 选项 。 

- Toolchain Root Location (工具 链 根 位 置 ) : 这 个 选项 是 指向 工具 链 安装 位 置 的 路 径 。 这 个 路 径 依赖 于 Toolchain Type: 

- Standalone Prebuilt Toolchain: 把 路 径 指向 你 安装 了 工具 链 的 位 置 。 在 我 们 的 例子 中 ， 那 是 /opt/poky/2.0。 

- Build System Derived Toolchain: 如 果 你 打算 使 用 构建 系统 衍生 的 工具 链 ， 那 么 把 路 径 指 向 你 的 构建 环境 的 顶级 目录 。 


- Sysroot Location (系统 根 位 置 ) : 这 个 选项 是 到 用 于 你 目标 的 系统 根 所 在 位 置 的 路 径 。 对 于 我 们 使 用 MinnowBoard Max 的 亭 项 目 ， 这 


是 /opt/poky/2.0/sysrtoots/corei7-64-poky-linuxo 
Target Options (目标 选项 ) : 这 个 部 分 配置 你 希望 用 在 你 的 Eclipse 设 置 中 的 目标 。 有 两 个 选择 : 


QEMU: 如 果 你 打算 使 用 QEMU 模 拟 器 来 测试 你 的 应 用 ， 那 么 选择 这 个 选项 。 如 果 你 正在 使 用 QEMU， 那 么 你 也 必须 提供 一 个 你 可 能 向 其 传递 额 
外 参数 的 内 核 。 


. External-HW: 这 个 选项 用 于 外 部 硬件 ， 它 是 我 们 正在 使 用 的 硬件 。 


单 击 Apply 以 使 Yocto 项 目 插件 验证 你 的 设置 并 且 保 存 设 置 。 单 击 OK 来 关闭 对 话 框 。Eclipse 和 Yocto 项 目 插件 现在 已 经 为 应 用 开 友 准备 好 了 。 


11.4.3” 开 友 应 用 


Yocto 项 目 Eclipse 插 件 提供 用 于 开发 C/C++ 应 用 (使 用 CMake 和 和 GNU Autotools) 的 项 目 模板 。 构 建文 件 ， 例 如 makefile， 是 用 满足 构建 系统 的 
cmake.bbclass 和 autotools.bbclass 类 的 需求 的 环境 设置 来 创建 的 。 因 此 ， 编 写 构建 你 用 Eclipse 和 Yocto 项 目 交 叉 工 具 链 开发 的 项 目的 菜谱 与 提供 
SRC_URI 和 继承 各 自 类 一 样 简单 。 


你 也 可 以 开发 仅仅 使 用 makefile 而 不 用 CMake 或 者 Autotools 的 应 用 。 然 而 ， 你 必须 手动 设置 用 于 交叉 工具 链 的 Eclipse 环 境 。 因 此 ， 我 们 推荐 你 遵 
循 已 提供 的 项 目 模 板 之 一 。 你 是 否 选择 用 CMake 或 者 Autotools 来 构建 项 目 依赖 于 你 的 项 目的 需求 以 及 你 的 个 人 喜好 。 


通过 启动 Eclipse 并 从 File 荣 单 中 选择 New>Projecthttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/... 来 开始 创建 你 的 新 项 目 。 从 New Project 对 话 框 中 ， 展 开 C/C++ 文 件 
夹 ， 从 C Project 或 者 C++Project 中 选择 其 一 。 接 下 来 的 例子 使 用 相同 的 源 代码 构建 一 个 简单 的 Hello World 方 式 的 项 目 ， 所 以 ， 选 择 C Project 或 者 
C++Project 没 有 什么 区 别 。 对 于 该 例 ， 我 们 选择 C Project。 


下 一 个 对 话 框 让 你 选择 你 希望 创建 的 项 目 类 型 。 选 择 有 : 
- Yocto Project ADT Autotools Project 
- Yocto Project ADT CMake Project 


它们 是 由 Yocto 项 目 Eclipse 插件 提供 的 ， 并 且 包 含 与 Yocto 项 目 交叉 工具 链 集成 的 模板 。 


开发 基于 CMake 的 应 用 
从 项 目 对 话 框 和 开始， 遵循 这 些 步骤 来 创建 你 的 项 目 : 


1.C 项 目 页 面 : 展开 文件 夹 Yocto Project ADT CMake Project， 从 列表 中 选择 Hello World C CMake Project。 这 创建 一 个 简单 的 项 目 ， 它 具有 一 
个 C 文 件 (包含 一 个 主要 函数 ) 、CMake 文 件 等 。 蔡 代 性 地 ， 你 可 以 选择 Empty Project， 然 后 你 需要 手动 创建 所 有 文件 。 在 顶部 的 Project Name 字 段 
处 输入 名 字 ， 保 持 Use default location 选 中 。 项 目 名 不 能 包含 任何 特殊 字符 串 或 者 空格 。 单 击 Next。 


2. 一 般配 置 页 面 : 如 果 你 希望 ， 那 么 输入 你 的 作者 信息 。 也 可 以 保持 页 面 空 日 ， 你 在 这 里 输入 的 信息 被 自动 加 载 到 源 文 件 的 一 个 头 文件 中 。 单 击 
Next, 


3. 选 择 配 置 页 面 : Debug 配 置 默认 是 被 选中 的 。 如 果 你 单 击 Advanced Settings， 项 目 属性 对 话 杠 打开。 项 Yocto Project Settings 包 含 带 有 交叉 开 
发 配置 文件 的 ADT 设 置 、 交 叉 编译 器 选项 和 目标 选项 。 字 段 用 我 们 前 面 输入 的 设置 预先 填充 了 。 通 过 选择 Use project specific settings， 你 可 以 覆盖 这 
些 设置 。 在 你 的 项 目 已 经 被 创建 后 ， 你 随时 都 可 以 通过 从 Eclipse 的 Project 荣 单 中 选择 Properties 来 回 到 这 个 对 话 框 。 单 击 Finish。 


4.C/C+ + EME] (Perspective) : 依赖 于 你 当前 的 Eclipse 状态 ，Open Perspective 提 示 可 能 出 现 询 问 你 是 否 希 望 改 到 C/C++Perspective。 确 定 打 
开 C/C++Perspective。Eclipse 把 它 的 不 同 环境 称 为 透视 图 。 依 赖 于 你 的 Eclipse 安 装 ， 有 用 于 Java、C/C++、 调 斌 等 的 透视 图 。 你 可 以 从 Eclipse 的 
Window 窗 口 菜单 或 者 使 用 位 于 Eclipse 窗 口 右上 角 的 按钮 在 视图 间 切 换 透 视 。 每 个 透视 可 以 有 多 个 视图 ， 它 显示 在 透视 图 的 工作 台 区 域 。 在 左 侧 ,你 看 
到 Project Explorer (项 目 浏 览 器 ) 视图 ， 它 显示 项 目 结构 和 文件 。 如 果 你 希望 编辑 文件 ， 那 么 在 Project Explorer 中 双击 它 的 名 字 ， 这 加 载 它 到 内 置 的 
编辑 器 中 。 


现在 你 可 以 容易 地 从 C/C++ 透视 图 内 执行 所 有 开发 任务 ， 包 括 用 Yocto 项 目 ADT 交 又 工具 链 构建 项 目 和 为 你 的 目标 构建 系统 根 。 可 用 下 面 两 种 方法 
中 的 任何 一 种 : 


- 从 Eclipse 的 Project 菜 单 中 选择 Build Project. 
- 在 Project Explotet 中 右键 单 击 项 目 名 称 并 选择 Build Project. 


在 构建 过 程 中 ， 当 然 ， 对 于 这 个 简单 项 目 ， 这 是 相当 迅速 的 ，Console 视 图 显示 各 个 构建 步骤 的 输出 。 如 果 有 任何 的 构建 错误 ， 那 么 Eclipse 切换 到 
Problems 视 图 。 如 果 构 建成 功 ， 那 么 Eclipse 在 Project Explorer 中 的 Binaries 下 面 显示 二 进 制 文件 。 


开发 基于 Autotools 的 应 用 


创建 和 构建 基于 Autotools 的 应 用 和 基于 CMake 的 应 用 没有 太 多 不 同 。 再 一 次 ， 从 项 目 对 话 框 中 开始 ， 尊 循 这 些 步骤 来 创建 你 的 项 目 : 


1.C 项 目 页 面 : 展开 文件 夹 Yocto Project ADT Autotools Project， 并 从 列表 中 选择 Hello World ANSI C Autotools Project。 在 顶部 的 Project 
Name 字 段 中 输入 名 字 ， 并 保持 Use default location 选 中 。 项 目 名 不 可 以 包含 任何 特殊 字符 或 者 空格 。 单 击 Next。 


2. 基 本 设置 页 面 : 如 果 你 希望 ， 那 么 输入 你 的 作者 信息 并 选择 许可 。 这 个 对 话 框 和 用 于 CMake 项 目的 General Settings 有 点 不 同 ， 但 是 它 具 有 类 似 
的 目的 。 单 击 Next。 


3. 选 择 配置 页 面 : 这 个 对 话 框 和 用 于 CMake 项 目的 完全 相同 。 单 击 Finish。 
4.C/C++ 透 视图 : 在 完成 后 ，Edlipse 和 直接 切换 到 C/C++ 透视 图 或 者 在 这 样 做 之 前 询问 你 ， 这 依赖 于 你 当前 的 Eclipse 状 态 。 
构建 基于 Autotools 的 应 用 包含 两 个 你 可 以 从 C/C++ 透视 图 内 执行 的 步 又 : 


. ACE: 在 Project Explorer 中 右键 单 击 项 目 名 称 并 选择 Reconfigure Project。 这 调用 autogen.sh 脚 本 ， 它 又 执行 libtoolize、aclocal、autoconf、autoheader、 
automake 和 和 configure， 类 似 于 在 11.3.2 小 节 中 我 们 在 命令 上 所 做 的 。 


- 构建 : 在 Project Exploret 中 右键 单 击 项 目 名 称 并 选择 Build Project. 


你 可 以 遵循 在 Console 视 图 中 的 步骤 。 在 成 功 构建 后 ，Eclipse 企 Project Explorer 中 的 Binaries 下 面 显示 二 进 制 文件 。 


1144 ”在 目标 上 部 署 、 运 行 和 测试 
集成 Yocto 项 目 ADT 工 具 链 和 Eclipse 使 得 创建 和 构建 基于 CMake 和 基于 GNU Autotools 的 项 目 简单 到 就 像 在 图 形 用 户 界面 中 点 几 下 鼠标 。 当 然 ， 你 
仍然 需要 编写 代码 ， 但 是 单调 之 味 的 操作 被 处 理 了 。 然 而 ， 在 目标 系统 上 部 署 、 运 行 和 测试 你 的 应 用 仍然 只 是 手动 复制 二 进 制 文件 到 目标 。 


Eclipse 的 TCF 为 完整 的 往返 开发 体验 增加 了 缺失 的 连接 。TCF 人 允许 复 制 二 进 制 文件 到 目标 系统 ， 远 程 地 在 目标 系统 上 运行 可 执行 应 用 ， 甚 至 直接 从 
Eclipse 内 远程 地 在 目标 系统 上 调试 应 用 。 


TCF 是 轻 量 级 但 是 可 扩展 的 网 络 协议 ， 它 主要 用 于 但 是 不 限于 与 诅 入 陈设 备 或 者 目标 通信 。 它 被 设计 成 用 于 开 友 系统 上 的 工具 的 框架 ， 其 使 用 标准 
化 且 不 依赖 于 特定 传输 层 〈 例 如 TCP/IP、 串 行 有 续 连 接 、SsH 隧 道 等 ) 的 通信 层 来 与 目标 服务 进行 交互 。 虽 然 TCP/IP 是 标准 通信 通道 ， 其 他 协议 是 可 用 
的 并 且 可 以 增加 。TCF 使 用 SON 用 于 数据 编组 (marshalling) ,而且 也 支持 目标 和 目标 上 服务 的 自动 友 现 。 位 于 其 核心 的 是 ，TCF 由 运行 在 目标 上 的 普 
通 C 实 现 的 可 扩展 代理 以 及 Java 客 户 端 API 组 成 。 后 者 与 各 种 Eclipse 工具 集成 ， 但 是 也 可 以 用 在 独立 的 应 用 中 。 


准备 目标 用 于 远程 控制 
为 了 能 够 使 用 Eclipse 和 TCF 来 远程 部 署 、 运 行 、 测 试 和 调试 应 用 ， 我 们 需要 通过 安装 所 需 的 组 件 来 准备 目标 根 文件 系统 。 


Yocto 项 目 提供 了 一 组 镜像 特性 ， 它 们 使 得 这 个 任务 变 得 相当 容易 和 和 直接。 所 有 你 要 做 的 是 ， 增 加 特性 tools-debug 和 eclipse-debug 到 你 构建 环境 
的 conf/local.conf 文 件 中 的 EXTRA IMAGE FEATURES: 


EXTRA_IMAGE FEATURES = "debug-tweaks tools-debug eclipse-debug" 
然后 重新 构建 镜像 
S bitbake -k ypbkiosk-image-sato 
并 且 部 署 尼 到 MinnowBoard Max 目 标 系统 ， 正 如 在 前 面 章节 中 所 解释 的 。 在 重启 了 板 后， 你 可 以 通过 在 目标 上 执行 以 下 命令 来 验证 TCP 代 理 正 在 
# ps | grep tcf-agent 


699 root 668m 5 /usr/sbin/tcf-agent -d -L- -10 
931 root 4412 R grep tcf-agent 


当然 ， 你 的 输出 有 很 大 可 能 是 稍微 不 同 的， 但 是 包含 /usYsbiny/tcf-agent 的 行 表示 TCF 代理 正 运行 在 目标 上 。 你 的 目标 现在 已 准备 好 接受 来 自 你 的 
Eclipse 工作 区 的 TCF 连接 。 


在 你 可 以 从 开 友 系统 上 的 Eclipse 工作 区 建立 到 目标 系统 的 TCP 连 接 之 前 ， 这 两 个 系统 需要 被 连接 到 相同 的 局 域 网 。 如 果 组 织 的 IT 部 门 不 允许 连接 你 
的 目标 系统 到 组 织 的 网 络 ， 那 么 你 可 能 希望 使 用 独立 的 路 由 器 和 开发 系统 的 额外 网 络 端口 。 


使 用 Eclipse 目标 浏览 


用 目标 浏览 器 ， 你 可 以 从 Eclipse 工作 区 检查 目标 系统 。 你 可 以 浏览 目标 的 文件 系统 、 列 出 运行 中 的 进程 以 及 终止 它们 和 向 它们 附加 调试 器 、 创 建 应 
用 启动 配置 。 


目标 浏览 器 使 用 TCF 的 发 现 机 制 ， 这 是 非常 好 用 的 ， 因 为 你 不 必 手 动 找 出 你 目标 的 I|P 地 址 [1j。TCF 发 现 机 制 扫描 你 的 局 域 网 以 寻找 监听 在 其 默认 端口 
1534 上 的 TCF 人 代理。 遵循 这 些 步骤 来 用 目标 浏览 器 建立 到 你 目标 的 连接 : 
1. 打 开 Target Explorer Perspective: 从 Eclipse Window 荣 单 选 择 Open Perspective， 并 且 从 子 菜单 中 选择 


Otherhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/...。 从 对 话 框 中 
的 透视 图 列表 中 ， 选 择 Target Explorer。Eclipse 自 动 切换 到 Target Explorer 透 视图 ， 在 其 左 侧 ， 有 System Management 标 签 。 


2.System Management 标 签 : System Management 标 签 包 含 一 个 3 文件 夹 列 表 : Favorites、Connections 和 Neighborhood。 如 果 你 从 来 没 使 
用 过 Target Explorer， 那 么 Favorites 文 件 夹 是 空 的 ，Connections 文 件 夹 有 一 个 名 为 Create New 
Connectionhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/... 的 条 目 。 


然而 ，Neighborhood 文 件 夹 为 友 现 机 制 已 经 在 局 域 网 上 找到 的 每 个 TCF 代 理 显示 一 个 条 目 ， 条 目的 形式 是 TCF Agent<ip 地 址 >。 


3. 建 立 连接 : 在 你 希望 连接 到 的 IP 地 址 的 TCF 代 理 上 右键 单 击 ， 并 且 从 菜单 中 选择 Connect。Eclipse 打 开 New Connection 对 话 框 。 对 话 框 的 字段 被 
用 友 现 机 制 已 经 检测 到 的 连接 参数 预先 填充 了 。 所 有 你 需要 做 的 是 ， 给 连接 一 个 有 意义 的 Connection Name (连接 名 字 ) 。 在 你 单 击 Finish 后 ，Eclipse 
连接 到 目标 上 的 TCF 代理 ， 并 且 为 新 连接 打开 了 一 个 标签 。 


4.Connection 标 签 : 依赖 于 连接 状态 ，Connection 标 签 有 多 个 显示 在 底部 的 子 标签 : 
a.Details (Overview) : 显示 连接 细节 。 仅 仅 当 连接 是 关闭 的 时 候 ， 字 段 才 可 以 被 修改 。 
b.Source Paths: 当 附 加 调试 器 到 进程 时 用 于 源 文件 的 搜索 路 径 。 默 认 情况 下 ， 这 些 是 目标 上 的 路 径 ， 但 是 开发 主机 上 的 路 径 可 以 被 增加 。 


c.Launches: 人 允许 启动 配置 的 创建 以 运行 安 六 在 目标 上 的 应 用 。 标 准 输 入 (stdin) 、 标 准 输出 (stdout) 和 标准 错误 (stderr) 通过 TCF 被 重 定向 
到 Eclipse 以 便 你 可 以 与 运行 中 的 应 用 交互 。 


d.Processes: 运行 在 目标 上 的 进程 列表 。 当 你 单 击 这 个 子 标签 时 ， 列 表 从 目标 上 被 获取 下 来 。 通 过 单 击 右 上 角 的 Refresh 按 钮 ， 你 可 以 再 次 加 载 
Ce 

e.File System: 让 你 浏览 目标 上 的 文件 系统 。 你 可 以 创建 新 的 文件 夹 和 文件 ， 移 动 它 们 ， 删 除 它 们 ， 复 制 它们 ， 重 命名 它们 。 你 也 可 以 搜索 目标 上 
的 文件 夹 和 文件 。 


如 果 你 曾经 用 Eclipse 开 友 过 原生 应 用 (也 就 是 ， 可 以 被 执行 在 开 友 系统 本 身上 的 应 用 ) ， 那 么 你 知道 ， 在 编译 了 之 后 ， 你 可 以 直接 从 Eclipse 内 的 开 
发 环境 (例如 C/C++ 或 者 Java 透 视图 ) 中 执行 和 调试 它们 。 用 TCF， 你 可 以 在 目标 上 做 相同 的 事情 。 它 要 求 一 些 配 置 步骤 ， 我 们 在 接 下 来 的 部 分 解释 这 


些 步 又 。 


在 目标 上 运行 应 用 


通过 Eclipse 的 Run Configurations， 你 可 以 设置 用 于 执行 应 用 的 环境 。 从 Eclipse 的 Run 菜 单 中 选择 Run 
Configurationshttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/17729/OEBPS/Text/..., {i 
局 动 了 一 个 对 话 框 ， 使 用 这 个 对 话 框 ， 你 可 以 创建 和 管理 你 的 环境 。 在 这 个 对 话 框 的 左 人 出，Eclipse 显 示 一 个 市 有 各 种 运行 配置 类 型 的 列表 ， 在 每 个 类 型 
下 面 ， 是 具有 预定 义 的 配置 的 列表 。 为 了 创建 用 于 在 远程 目标 上 执行 我 们 的 C/C++ 应 用 的 运行 配置 ， 你 选择 C/C++Remote Application， 然 后 单 击 位 
于 列表 上 面 左 上 角 的 New 按 钮 。 


1.Name: 基于 当前 的 项 目 ，Eclipse 为 你 的 运行 配置 填 入 名 字 。 如 果 它 满足 你 的 需求 ， 那 么 接受 默认 ; 否则 输入 新 的 名 字 。 
2. 主 标签 : 


a.Connection: 通过 单 击 Newhttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/... 创 建新 连接 。 


ij. 从 列表 中 选择 TCF 并 单 击 Next> 。 
i. 在 Host Name 字 段 中 输入 你 的 目标 板 的 IP 地 址 , 或 者 ， 如 果 你 有 本 地 DNS， 输 入 主机 名 。 
i. 在 字段 Connection Name 中 为 你 的 连接 输入 名 字 。 


iv 如果 你 希望 ， 那 么 输入 一 个 Description (描述 ) 。 


b. 项 目 : Eclipse 字 段 自动 填 入 你 当前 的 项 目 名 字 。 如 果 那 不 是 你 希望 的 项 目 ， 使 用 Browsehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/... 按 钮 选择 一 个 不 同 的 项 目 。 


c.Build configuration (构建 配置 ) : Eclipse 自 动 选择 项 目的 当前 配置 。 通 过 从 列表 中 选择 一 个 不 同 的 来 覆盖 它 。 


d.C/C++application: 一 个 项 目 可 能 构建 不 止 一 个 应 用 。 使 用 Search Projecthttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/... 来 选择 正确 的 可 执行 文件 。 


e.Remote absolute file path for C/C++application (用 于 C/C++ 应 用 的 远程 绝对 文件 路 径 ) : 这 个 字段 包含 目标 上 应 用 的 绝对 路 径 和 名 字 。 
Eclipse 复 制 应 用 到 那个 路 径 。 你 可 以 选择 一 个 不 同 于 由 Eclipse 构 建 过 程 创建 的 可 执行 文件 的 名 字 。 使 用 
Browsehttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/... 来 选择 在 目标 
上 的 路 径 ， 然 后 追加 一 个 名 字 ， 例 如 /usr/bin/hello。 


f.Commands to execute before application (在 应 用 前 执行 的 命令 ) : 在 这 个 字段 中 ， 你 可 以 输入 在 Eclipse 局 动 应 用 前 于 目标 上 执行 的 额外 命 


令 。 把 它 留 空 。 
g.Skip download to target path ( 略 过 下 载 到 目标 路 径 ) : 不 要 选中 这 个 框 。 你 希望 Eclipse 每 次 下 载 你 的 应 用 到 目标 以 便 你 的 最 新 变更 被 应 用 。 
3.Arguments Tab (参数 标签 ) : 如 果 你 的 应 用 要 求 命令 行 参数 ， 那 么 你 可 以 输入 它们 到 Program Arguments (程序 参数 ) 字段 。 


4.Common Tab (一 般 标签 ) : 用 于 运行 配置 的 一 般 设 置 是 通过 Common 标 签 来 访问 的 。 在 大 部 分 情况 下 ， 默 认 设 置 是 合适 的 。 如 果 你 希望 
Eclipse 存 储 你 应 用 的 输出 ， 选 中 File 并 且 提 供用 于 存储 输出 的 文件 的 路 径 和 名 字 。 


先后 单 击 对 话 框 底部 的 Apply 和 Run 来 使 你 的 应 用 在 目标 上 启动 起 来 。 如 果 这 是 Eclipse 第 一 次 使 用 这 个 连接 在 那个 目标 上 运行 应 用 ， 那 么 它 会 展示 给 
你 一 个 对 话 框 询 问 用 于 执行 应 用 的 用 户 ID 和 密码 。 输 入 rootf 作 为 用 户 ID， 密 码 保持 为 空 。 因 为 标准 Yocto 项 目镜 像 仅仅 有 一 个 不 市 密码 的 root 用 户 账 


ei 


Zo 
当 Eclipse 首 先 构建 你 的 应 用 、 然 后 传输 它 到 目标 以 及 最 后 执行 它 的 时 候 ， 观 察 在 Eclipse 内 的 Console 窗 口 。Console 窗 口 应 该 显示 类 似 如 下 的 输 
ae 


root@ypbkiosk: /# 

echo SPWD'>' 

/> 

root@ypbkiosk:/# /usr/bin/hello;exit 
Hello World! 

logout 


Eclipse 和 TCF 仅仅 把 标准 输入 (stdin) 、 标 准 输出 (stdout) 和 标准 错误 (stderr) 从 目标 重 定向 到 位 于 Eclipse 内 的 终端 。 如 果 你 的 目标 应 用 是 图 
形 化 应 用 ， 那 么 它 的 输出 被 展示 在 连接 到 目标 硬件 的 屏幕 上 。 简 言 乙 ， 这 是 有 意义 的 ， 因 为 你 将 希望 用 本 地 屏幕 来 测试 你 的 应 用 。 


在 目标 上 调试 应 用 


和 用 于 在 目标 上 执行 应 用 的 Run Configurations (运行 配置 ) 类 似 ，Eclipse 提 供 了 用 于 在 目标 上 调试 应 用 的 Debug Configurations (调试 配 
置 ) 。 为 了 调试 ， 应 用 或 者 程序 从 调试 器 的 上 下 文 内 被 启动 。 然 后 调试 器 控制 和 监控 程序 的 运行 并 且 提 供 对 程序 使 用 的 变量 、 栈 、 动 态 存储 、 文 件 措 针 
等 的 访问 。 


远程 调试 需要 这 样 一 个 调试 器 : 它 能 够 在 目标 上 执行 程序 而 同时 通过 例如 网 络 连 接 或 者 串 行 连接 的 链 路 从 不 同 的 系统 (FRE) 控制 和 监控 它 。 


GDB 是 用 于 Linux 系 统 的 标准 调试 器 ， 有 一 个 匹配 的 服务 器 (gdbserver) 用 于 远程 调试 。 在 主机 系统 上 运行 的 GDB 和 在 目标 系统 上 运行 的 gdbserver 通 
过 使 用 TCP 的 网 络 连接 或 者 通过 串 行 连 接 来 通信 。 


理解 用 于 远程 调试 的 主要 Eclipse 工 作 流 是 有 用 的 ， 因 为 它 使 用 TCF 和 用 于 调试 器 的 通信 协议 的 组 合 : 
1.Eclipse 通 过 TCF 下 载 应 用 到 目标 系统 。 


2. 通 过 TCF 利用 类 似 gdbserver host: 2345<program> <arguments> 的 命令 ，Eclipse 在 目标 系统 上 启动 gdbserver 和 被 调试 的 应 用 。 人 参数 host: 
2345 表 示 使 用 在 端口 2345 (gdbserver 默 认 端 口 ) 上 的 TCP 连 接 ，<program> 是 Eclipse 在 前 面 步 又 中 下 载 的 应 用 ， 如 果 提 供 了 <arguments> ， 那 么 它 
们 是 传递 到 应 用 的 命令 行 参数 。 


3.Eclipse 在 开发 系统 或 者 主机 上 启动 GDB 并 且 切 换 到 调试 透视 图 。 


4. 通 过 GDB/VMI 接 口 ，Eclipse 使 用 命令 target remote<target>: 2345 指 示 GDB 连 接 到 运行 在 目标 上 的 gdbserver， 其 中 <target> 是 目标 的 主机 名 
(如 果 DNS 是 可 用 的 ) 或 者 是 IP 地 址 。 


5.GDB 在 目标 上 启动 应 用 ， 并 且 把 执行 保持 在 main() 滔 数 的 第 一 个 指令 

6. 现 在 通过 由 Eclipse 的 调试 透视 图 提供 的 图 形 用 户 界面 ， 你 可 以 用 GDB 控 制 和 监控 应 用 了 。 

GDB 提 供 了 多 个 命令 解释 器 和 命令 基础 设施 ， 用 户 和 其 他 应 用 可 以 通过 它们 与 GDB 交 互 : 

-GDB/CLI: 经 常 被 用 户 使 用 的 控制 台 或 者 命令 行 解 释 器 。 它 以 人 可 读 的 形式 提供 了 简单 的 命令 基础 设施 。 这 是 默认 的 解释 器 。 

-GDB/MI: 通常 被 其 他 应 用 (例如 Eclipse 和 其 他 GDB 前 端 使 用 的 机 器 解释 器 。GDB/MI 有 两 个 版 本 一 一 mil 和 mi2。 后 者 是 当前 版 本 。 

所 有 GDB 解 释 器 使 用 stdin 来 接受 命令 ， 使 用 stdout 用 于 信息 和 数据 输出 ， 使 用 stderr 用 于 错误 消息 。Eclipse 使 用 最 新 的 GDB/MI 版 本 ，mi2。 


创建 调试 配置 并 不 比 创建 运行 配置 困难 很 多 。 事 实 上 ， 如 果 你 已 经 为 你 的 应 用 创建 了 运行 配置 ， 那 么 Eclipse 使 用 它 作为 起 点 。 从 Eclipse 的 Run 菜 单 
中 选择 Debug Configurationshttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/.… 来 打开 配置 编辑 器 。 该 对 话 框 和 Run Configurations 对 话 框 看 起 来 几乎 
一 模 一 样 。 在 左 侧 ,是 应 用 类 型 的 列表 。 如 果 你 正如 在 前 面部 分 所 摘 述 的 那样 创建 了 运行 配置 ， 那 么 Eclipse 很 可 能 已 经 在 列表 中 高 亮 显示 了 那个 配置 并 
且 正 在 右 侧 显示 配置 细节 。 


Main、Arguments、Common 标 签 让 你 查看 和 编辑 与 Run Configurations 对 话 框 中 各 自 对 应 标签 相同 的 信息 。 在 前 面部 分 ， 我 们 解释 了 它们 。 
Debugger 和 source 标签 是 新 的 : 


- Debugger Tab (调试 标签 ) : 在 这 里 ， 你 可 以 配置 GDB: 


- Stop on startup at: 如 果 选 中 并 且 在 它 沈 边 的 字段 中 提供 了 函数 名 ， 那 么 GDB 在 所 提供 函数 的 第 一 个 指令 处 设置 断 点 。 在 启动 时 ，GDB 执 行程 序 直 
到 它 抵达 断 点 。 默 认 设 置 是 在 main( 时 暂停 执行 。 如 果 你 正在 调试 复杂 程序 并 且 你 对 程序 在 开始 发 生 了 什么 不 感 兴趣 ， 那 么 设置 它 为 不 同 的 函数 。 


- Main Subtab 〈 主 子 标签 ) : 用 于 GDB 的 一 般 设置 : 
- GDB Debugger: 这 个 设置 用 于 GDB 调 试 器 的 路 径 和 名 字 。 这 个 信息 应 该 已 经 被 Yocto 项 目 播 件 正确 填写 为 指向 到 用 于 平台 的 交叉 调试 器 。 


- GDB Command File (GDB 命 令 文件 ) : 这 个 设置 指向 用 于 GDB 的 项 目 命 令 文件 。 调 试 器 在 启动 时 读 取 这 个 文件 。 文 件 名 通常 是 .gdbinit 并 且 位 于 


Eclipse 项 目 目 KA 
- Non-stop Mode (不 间断 模式 ) : 如 果 选 中 ， 这 个 设置 允许 你 调试 多 线程 程序 的 已 停止 线程 而 其 他 线程 则 正常 运行 。 


- Enable Reverse Debugging (启用 反 向 调试 ) : 在 这 个 设置 被 选中 的 情况 下 ， 你 可 以 在 程序 中 向 后 步 进 和 继续 。 一 般 情 况 下 ， 你 仅仅 可 以 按照 程序 流 
的 顺序 步 进 和 继续 。 这 个 GDB 功 能 性 仍然 被 局 限 到 特定 架构 和 平台 ， 并 且 对 远程 调试 来 说 一 般 是 不 可 用 的 。 


- Force Thread List Update on Suspend (暂停 时 强制 线程 列表 更 新 ) : 当 线 程 遇 到 断 点 时 ， 这 个 设置 自动 在 Eclipse 调试 透视 图 中 更 新 线程 信息 


Automatically Debug Forked Processes 〈 自 动 调 试 派生 的 进程 ) : 通常 ，GDB 调 试 器 附加 到 主 进程 。 如 果 那 个 进程 创建 子 进程 ， 那 么 GDB 继 续 调 试 主 


进程 。 新 版 本 的 GDB 可 以 附加 到 派生 的 进程 。 启 用 这 个 选项 以 使 GDB 也 自动 附加 到 子 进程 上 。 


Tracepoint Mode (3237 RHA) : 对 于 一 些 应 用 ， 特 别 是 实时 应 用 ,设置 断 点 和 检查 变量 是 不 可 行 的 ， 因 为 暂停 程序 修改 了 时 序 特征 (timing 


characteristic) 。 在 那 种 情况 下 ， 开 发 者 可 以 使 用 追踪 点 来 让 GDB 自 动 收集 和 报告 数据 。 在 一 般 模式 下 (Normal mode) , i237 846 AM SARs A 2) 4AF 
中 ; 在 快速 模式 下 (Fast mode) ， 追 踪 点 作为 跳 追 踪 点 (jump tracepoint) 被 插入 到 程序 中 。 不 是 在 所 有 平台 上 和 全 部 条 件 下 都 支持 跳 追 踪 点 。 自 动 模式 


(Automatic mode) 把 决定 权 留 给 调试 器 。 


- Shared Libraries Subtab (共享 库 子 标签 ) : 在 这 个 子 标签 中 ， 你 可 以 向 文本 框 中 增加 目录 路 径 到 额外 的 共享 库 。 标 准 共享 库 是 已 知 的 并 且 被 默认 加 
载 。 如 果 你 希望 调试 共享 库 ， 那 么 你 需要 选中 Load Shared Library Symbols Automatically (自动 加 载 共 享 库 符 号 ) 选项 。 


- Gdbsetver Settings Subtab (Gdbservet 设 置 子 标签 ) : 目标 上 的 gdbsetvet 可 执行 文件 的 名 字 和 路 径 被 显示 在 这 个 子 标签 中 。 默 认 是 gdbservet， 这 对 
Yocto 项 目 目标 镜像 是 足够 的 ， 为 gdbsetvet 位 于 默认 PATH 中 。potrt number (端口 号 ) 是 用 于 运行 在 主机 上 的 GDB 和 运行 在 目标 上 的 gdbserver 之 间 通 信 的 
了 CP 端口 。 默 认 是 2345。 


- Source Tab ( 源 标签 ) : 当 在 程序 中 步 ， 调 试 器 需要 显示 源 代码 以 便 你 可 以 有 效 地 追踪 程序 。 为 了 那个 目的 ， 调 试 器 需要 能 够 定位 和 加 载 源 
文件 。 增 加 到 Soutce Lookup Path 〈 源 查找 路 径 ) 列表 中 的 路 径 服务 于 那个 目的 。Eclipse 默 认 增 加 项 目 路 径 。 如 果 你 需要 调试 任何 共享 库 ， 那 么 你 必须 增 
加 它们 的 路 径 到 那个 列表 以 能 够 看 到 它们 的 源 。 


通过 单 击 Apply 接 受 修改 ， 然 后 通过 单 击 Debug 启 动 调试 器 。Eclipse 局 动 调试 器 并 且 切 换 到 调试 透视 图 。 执 行 在 main0 函 数 的 第 一 个 指令 处 暂停 。 
现在 ,你 可 以 在 运行 于 目标 上 的 程序 中 步 进 代码 ， 设 置 断 点 并 检查 变量 ， 正 如 对 本 地 的 运行 在 调试 器 中 的 程序 所 做 的 一 样 。 


BEFRA 


你 可 以 使 用 调试 器 追踪 到 共享 库 (例如 C 库 libc) 的 函数 。 然 而 ， 调 试 器 不 能 展示 源 代 码 ， 因 为 它 没有 关于 从 哪里 定位 源 代 码 的 信息 。 当 构建 SDK 
时 ， 构 建 系统 自动 在 系统 根 中 为 所 有 已 安装 的 包 (包括 标准 共享 库 ) 增加 调试 和 源 包 。 为 了 告诉 调试 器 在 哪里 找到 源 文件 ， 我 们 必须 增加 必要 信息 到 位 
于 Eclipse 工作 区 的 项 目 目录 中 的 .gdbinit 文 件 (程序 清单 11-5) 。 


程序 清单 11-5 GDB 局 动 文 件 .gdbinit 


set sysroot /opt/poky/2.0/sysroots/corei7-64-poky-linux 
set substitute-path /usr/src/debug \ 
/opt/poky/2.0/sysroots/corei7-64-poky-linux/usr/src/debug 


程序 清单 11-5 显 示 一 个 样 例 .gdbinit 文 件 ， 它 为 GDB 设 置 路 径 以 为 安 半 在 /opt/poky/2.0 的 SDK 定 位 用 于 库 调 试 的 源 文 件 。 


- Set sysroot: 指定 包含 被 安装 在 目标 上 的 库 的 副本 的 目录 。 这 个 路 径 使 调试 器 能 定位 和 加 载 库 以 及 它们 的 符号 。 这 是 到 安装 在 你 开发 系统 的 Yocto 
项 目 SDK 的 路 径 。 


- set substitute-path: 为 调试 器 指定 替换 规则 以 找到 用 于 库 的 源 文 件 。 为 Linux 编 译 的 标准 的 可 执行 文件 和 库 用 /ust/stc/debug 作 为 路 径 前 组 记录 它 
们 的 编译 目录 。substitute-path 命 令 使 得 GDB 在 定位 源 文 件 时 用 第 二 个 目录 片段 蔡 换 第 一 个 目录 片段 。 


不 乎 的 是 ，Eclipse 不 提供 任何 方法 来 赋予 GDB 配 置 设置 ， 例 如 但 是 不 限于 在 前 面 所 显示 的 用 于 交叉 调试 的 配置 设置 。 然 而 ， 你 可 以 使 用 Eclipse 的 文 
本 编辑 器 修改 .gdbinit 文 件 。 因 为 该 文件 是 Linux/UNIX 系 统 上 的 隐藏 文件 ， 所 以 默认 情况 下 Eclipse Project Explorer 不 显示 它 。 在 Project Explorer 劳 边 
的 菜单 中 单 击 向 下 的 箭头 ， 然 后 从 菜单 中 选择 Customize Viewhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/17729/OEBPS/Text/...。 然 后 移 除 .*resources 旁 边 的 选择 标记 。 蔡 代 性 地 ， 你 可 以 在 Debug 
Configuration 对 话 框 中 给 予 GDB Command File 不 同 的 文件 名 以 使 它 不 再 是 隐藏 文件 (文件 名 前 没有 逗号 ) 。 


1] 并 不 是 说 在 目标 系统 上 运行 ifconfig 是 非常 困难 的 ， 而 是 因为 它 需 要 串 行 终端 或 者 屏幕 和 键盘 。 


11.5 ”使 用 模拟 目标 的 应 用 开 友 


多 奶 入 陈 项 目 是 硬件 和 软件 工程 共同 努力 的 成 果 。 实 际 的 目标 硬件 ， 或 者 甚至 早期 工程 样品 ， 对 软件 开 友 来 讽 ， 可 能 不 能 很 好 地 融 绪 于 开 妈 周期 
中 。 为 了 编 短 开 上 友 周 期 ， 与 硬件 开 友 并 行 ， 你 可 能 希望 在 项 目 早期 残 开始 在 应 用 软件 上 开 上 软件 。 一 种 方法 是 使 用 例如 BeagleBone、MinnowBoard 
Max、Wandboard 以 及 其 他 类 似 于 你 项 目的 目标 硬件 的 廉价 开 友 板 。 另 一 种 方法 是 使 用 目标 模拟 。 目 标 模 拟 也 有 这 样 的 优点 一 应 用 开发 者 不 必 处 理 
从 入 式 硬件 ， 因 为 他 们 可 以 使 用 目 己 的 开 友 系统 构建 和 测试 应 用 。 


Yocto 项 目 使 用 QEMU 用 于 目标 模拟 。 我 们 已 经 在 全 书 中 使 用 QEMU 用 于 测试 各 种 Yocto 项 目 系 统 构建 。 现 在 ， 我 们 举例 说 明 如 何以 Yocto 项 目 SDK 


和 Eclipse 使 用 QEMU 用 于 应 用 开发 。 


11.5.1 为 用 QEMU 进 行 应 用 开发 做 准备 


我 们 需要 两 个 东西 用 于 用 模拟 目标 进行 应 用 开 友 : 
- 用 于 QEMU 的 Linux 内 核 和 根 文件 系统 
- 匹配 前 者 的 ADT 


当然 ， 我 们 用 构建 系统 构建 这 两 者 。 我 们 已 经 有 了 构建 环境 ， 我 们 曾 使 用 它 来 为 用 在 MinnowBoard Max 上 的 亭 项 目 创建 过 和 镜像。 我 们 仪 仪 需要 把 
机 器 从 ypbkiosk 改 到 QEMU 机 器 。 使 用 其 核心 架构 类 似 于 实际 硬件 目标 的 模拟 机 器 是 很 有 意义 的 。 因 为 MinnowBoard Max 是 配备 了 64 位 x86 CPU, Ar 
以 我 们 选择 qemux86-64 作 为 机 器 。 把 构建 环境 的 conf/local.conf 的 MACHINE 变 量 改 成 qemux86-64， 然 后 用 以 下 命令 启动 BitBake: 


S bitbake -k ypbkiosk-image-sato 
来 构建 Linux 内 核 和 ypbkiosk-image-sato 根 文件 系统 镜像 。 一 旦 构建 完成 ， 用 以 下 命令 创建 匹配 的 SDK: 
9 bitbake -c populate sdk ypbkiosk-image-sato 


一 旦 那 完 成 了 ， 则 安装 ADT， 正 如 在 11.2.2 小 节 中 所 解释 的 。 你 可 以 安全 地 把 ADT 安 六 在 相同 的 /opt/poky/<version> 目 录 ， 因 为 工具 链 、 系 统 根 
和 局 动 脚本 具有 唯一 名 字 并 且 是 互相 分 开 的 。 


解压 根 文件 系统 


Eclipse 用 从 开发 主机 上 通过 网 络 文 件 系统 (Network File System, NFS) 导出 的 根 文件 系 统 启 动 QEMU。 为 了 用 QEMU 和 NFS 设 置 根 文 件 系 统 ， 
我 们 需要 解压 和 准备 在 前 面 步 又 中 已 创建 的 根 文件 系统 。ADT 包 含 一 个 执行 所 有 必要 工作 的 脚本 。 


1. 改 变 目 录 到 ADT 安 六 目录 : 
S cd /opt/poky/<version> 
2. 引 用 QEMU ADT 环 境 : 
9 source environment-setup-core2-64-poky-linux 
3. 改 变 目 录 到 sysroots: 
S cd sysroots 
4. 从 构建 环境 解压 根 文 件 系统 : 
S rungemu-extract-sdk \ 
/<path-to-build-environment>/tmp/deploy/images/qemux86-64/ \ 


ypbkiosk-image-sato-gemux86-64.tar.bz2 \ 
core2-64-poky-linux 


5. 从 构建 环境 复制 Linux 内 核 镜像 : 


S cp /<path-to-build-envrionment>/bzImage-qemux86-64.bin \ 
core2-64-poky-linux/boot 


对 NFs 来 说 ， 你 的 开 友 系统 必须 要 有 rpcbind 一 一 通用 地 址 到 远程 过 程 调 用 程序 数字 映射 器 (RPC Program Number Mapper) HORRE. (cH 


于 你 的 系统 配置 ， 你 可 能 需要 使 用 系统 包 管 理 器 来 安装 它 ， 例 如 ， 在 Ubuntu 上 使 用 sudo apt-get install rpcbind。 而 且 ， 为 了 使 用 用 户 空 间 
NFS，rpcbind 需 要 运行 在 非 安 全 模式 ， 人 允许 来 自任 何 主 机 的 SET 和 UNSET。 为 了 启用 非 安 全 模式 ， 你 需要 增加 -i 选 项 到 rpcbind 启 动 配置 。 在 Ubuntu 
上 ,增加 -i 到 文件 /etc/init.d/rpcbind 中 的 OPTIONS 变 量 并 且 用 命令 sudo service rpcbind restart 重 局 rpcbind。 


与 Eclipse 集成 
现在 我 们 需要 把 ADT 和 解压 用 于 QEMU 的 根 文件 系统 与 Eclipse 集 成 。 


从 Eclipse Window 菜 单 中 打开 Preferences 对 话 框 ， 单 击 Yocto Project ADT， 并 且 遵 循 这 些 指令 来 创建 用 于 用 QEMU 进 行 应 用 开 友 的 新 的 交叉 开 
发 配置 文件 : 


1.Cross Development Profiles (交叉 开 友 配置 文件 ) : 交叉 开发 配置 文件 列表 中 的 Standard Profile (标准 配置 文件 ) 应 该 反映 我 们 在 前 面 章节 中 
用 于 MinnowBoard Max 的 设置 。 保 存 Standard Profile 为 MinnowBoard Max， 然 后 把 选择 改 回 Standard Profile, 


2.Cross Compiler Options (交叉 编译 选项 ) : 保持 用 于 Standalone Pre-built Toolchain (独立 预 构建 工具 链 ) 和 Toolchain Root Location (T 
具 链 根 位 置 ) 。 点 击 Sysroot Location (系统 根 位 置 ) 旁 的 Browsehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/17729/OEBPS/Text/... (浏览 ) ,浏览 到 /opt/poky/<version>/sysroots/core2-64-poky- 
linux， 这 是 我 们 解压 根 文 件 系 统 所 到 的 位 置 。 从 Target Architecture (目标 架构 ) 列表 中 ， 选 择 core2-64-poky-linux。 


3.Target Options (目标 选项 ) : 选择 QEMU， 并 且 浏 览 到 我 们 将 Linux 内 核 复制 到 的 位 置 : /opt/poky/<version>/sysroots/core2-64-poky- 
linux/boot/bzlmage-qemux86-64.bin, 


现在 Eclipse 已 经 准备 好 用 QEMU 进 行 应 用 开发 。 


11.5.2 ”构建 应 用 并 在 QEMU 中 启用 它 


现在 你 可 以 按照 11.4.3 小 节 中 所 描述 的 那样 创建 新 应 用 项 目 。 创 建 了 项 目 后 ， 在 Project Explorer 中 右键 单 击 它 的 名 字 ， 并 选择 位 于 列表 底部 的 
Yocto Project Settings。 从 Cross Development Profiles， 选 择 QEM U 配 置 文件 ， 单 击 Apply。 你 的 项 目 现在 使 用 用 于 QEMU 的 交叉 工具 链 来 编译 和 调 
试 。 


为 了 执行 和 调试 你 的 应 用 ， 你 首先 需要 启动 QEMU。 在 Eclipse 的 Run 菜 单 中 选择 External Tools。 子 菜单 的 第 一 个 条 目 是 我 们 刚刚 创建 的 QEMU 集 
成 : qemu_core2-64-poky-linux。 在 其 上 单 击 ，Eclipse 局 动 终端 窗口 ， 它 从 该 窗口 内 启动 QEMU。QEMU 本 身 在 第 2 个 窗口 中 局 动 。 


借助 TCF 和 GDB/gdbserver， 使 用 运行 配置 和 调试 配置 在 模拟 的 目标 上 部 署 、 执 行 和 调试 你 的 应 用 ， 正 如 在 11.4.4 小 节 中 所 解释 的 。 


11.6 BZ 


IONE 


操作 系统 栈 和 中 间 件 组 成 设备 的 基础 。 应 用 和 用 户 软 件 为 最 终 用 户 创造 价值 。Yocto 项 目 应 用 开 上 友 工 具 包 提供 给 应 用 开 妈 者 用 以 为 他 们 的 目标 设备 构 
建 、 测 试 和 部 署 应 用 的 必要 工具 。 


.Yocto 项 目 ADT 包 含 交 叉 开 发 工具 链 、 用 于 硬件 目标 设备 和 模拟 的 目标 的 系统 根 、QEMU 模 拟 器 、 测 试 和 分 析 工 具 以 及 便于 开发 环境 设置 的 集成 脚 


` 通过 包含 用 于 构建 设备 的 Linux 操 作 系 统 栈 的 一 模 一 样 的 工具 链 和 通过 打包 设备 的 根 文 件 系 统 镜像 ， 构 建 系统 创建 匹配 目标 设备 的 ADT。 
-为 了 传统 开发 以 及 与 构建 工具 的 集成 ，ADT 交 又 开 发 工具 可 以 直接 从 命令 行使 用 。 设 置 仅仅 需要 引用 设置 必要 环境 变量 的 脚本 。 
- ADT 和 Eclipse IDE 的 集成 从 图 形 用 户 界面 的 便利 性 方面 提供 了 对 交叉 开发 工具 的 访问 。 


Eclipse 的 目标 通信 框架 (TCF) 允许 直接 从 IDE 对 实际 目标 硬件 以 及 模拟 的 目标 进行 部 署 、 执 行 和 调试 。 


11.7 参考 文献 


Yocto 项 目 应 用 开发 者 指南 ,www.yoctoproject.org/docs/2.0/adt-manual/adt-manual.html,。 


Yocto 项 目 开 发 手册 ,www.yoctoproject.org/docs/1.8/dev-manual/dev-manual.html。 


第 12 章 ” 计 可 和 合 规 


功能 齐全 的 Linux 操 作 系统 栈 由 几 百 个 ， 也 可 能 是 几 和 干 个 开源 软件 包 组 成 。 这 些 软件 包 是 由 它们 的 作者 以 众多 开源 许可 的 条 款 和 条 件 来 友 布 的 。 几 乎 
所 有 这 些许 可 都 要 求 最 终 用 户 被 赋予 对 许可 文本 的 访问 以 把 使 用 软件 时 的 权利 和 可 能 的 义务 通知 给 他 们 。 作 为 系统 构建 者 ， 你 正在 构建 由 很 多 不 同 开源 
软件 包 所 组 成 的 完整 系统 ， 你 需要 收集 所 有 许可 信息 并 且 将 其 提供 给 你 系统 的 用 户 。 除 了 提供 许可 信息 ， 一 些 开 源 许 可 ， 特 别 是 CNU 通 用 公共 许可 
(GNU General Public License, GPL) ， 要 求 你 提供 用 于 构建 软件 包 二 进 制 文件 的 源 人 代码。 收集、 管理 和 提供 许可 信息 及 源 代码 可 能 是 耗 时 的 任务 。 
Yocto 项 目 通 过 提供 一 组 工具 来 极 大 地 简化 了 这 个 任务 ， 这 些 工具 会 处 理 开源 许可 和 源 代码 管理 中 单调 乏味 的 部 分 。 


12.1.2 通用 许可 
OpenEmbedded 核 心 元 数据 层 在 目录 meta/files/common-licenses 中 包含 用 于 通用 许可 的 文件 和 许可 文本 。 这 个 目录 是 由 变量 
COMMON _LICENSE_DIR 所 引用 的 。 你 可 以 把 这 个 变量 和 通用 许可 文件 名 用 于 LIC_FILES_ CHKSUM， 例 如 : 


LIC_FILES_CHKSUM = "\ 
file://S{COMMON_LICENSE_DIR}/GPL-2.0;md5=801£80980d171dd6425610833a22dbe6" 


然而 ， 我 们 推荐 仅仅 在 源 包 实际 上 不 包含 许可 文本 而 仪 仪 包含 到 文件 中 通用 许可 的 引用 时 才 这 样 做 。 在 这 种 情况 下 ， 我 们 也 推荐 你 包含 含有 对 
LIC_FILES CHKSUM 引 用 的 文件 。 理 由 是 ， 仅 仅 使 用 通用 许可 文件 实际 上 禁用 了 许可 追踪 机 制 。 包 源 内 的 许可 信息 变更 可 能 不 会 被 构建 系统 注意 到 ， 
为 菜谱 使 用 了 通用 许可 文件 。 


通过 增加 一 个 或 者 多 个 你 自己 的 许可 目录 到 LICENSE_ PATH 变量， 你 可 以 为 构建 系统 提供 用 于 搜索 的 目录 : 


LICENSE_PATH += "/path/to/my/licenses" 


这 个 变量 可 能 包含 由 空格 分 隔 的 目录 列表 。 构 建 系 统 增加 变量 的 路 径 到 由 COMMON _LICENSE_DIR 提 供 的 路 径 。 


12.1.3 ”商业 许可 的 包 

一 些 软件 包 ， 虽 然 是 开源 的 ， 但 却 是 使 用 商业 许可 或 者 不 符合 开源 许可 的 特殊 许可 条 款 和 条 件 来 许可 的 。 构 建 这 种 包 的 菜谱 通过 设置 变量 
LICENSE_FLAGS 来 标志 特殊 许可 需求 : 例如 ，LICENSE_FLAGS= "commercial 。 

LICENSE_FLAGS 变 量 可 以 包含 任何 字符 串 ， 但 是 一 旦 菜谱 设置 了 变量 ， 构 建 系统 不 会 构建 软件 包 ， 除 非 它 是 被 显 式 地 局 用 的 。 


为 了 启用 特殊 的 许可 标志 ， 你 增加 它 到 LICENSE_FLAGS_WHITELIST 变 量 。 变 量 包含 空格 分 隔 的 许可 标志 列表 。 构 建 系统 把 由 菜谱 设置 的 许可 标志 
和 LICENSE FLAGS_WHITELIST 变 量 中 的 许可 标志 列表 进行 匹配 。 然 而 ， 在 这 样 做 之 前 ， 它 把 包 名 PN 人 姐 加 到 定义 在 菜谱 的 LICENSE_FLAGS 中 的 许可 标 
志 。 例 如 ， 对 于 构建 hello 包 包含 如 下 的 菜谱 : 


LICENSE FLAGS = "commercial" 


变量 实际 上 成 为 : 


LICENSE FLAGS = "commercial hello" 
通过 设置 
LICENSE FLAGS WHITELIST = "commercial hello" 


你 现在 可 以 特殊 启用 hello 菜 谱 或 者 通过 设置 
LICENSE FLAGS WHITELIST = "commercial" 


SERA ae HrellitainmAsie, Bishello, 


这 种 匹配 方案 可 以 让 你 精确 控制 要 启用 构建 的 包 。 通 过 在 你 菜谱 的 LICENSE FLAGS 中 显 式 地 指定 包 名 PN 和 包 版 本 PV， 你 可 以 更 进一步 控制 。 考 虑 
构建 hello 包 的 菜谱 包含 : 


LICENSE FLAGS = "commercial S${PN}_S{PV}" 
这 使 得 你 可 以 仅仅 启用 一 个 特定 版 本 的 hello 菜 谱 ， 例 如 版 本 1.0， 通 过 使 用 以 下 命令 : 
LICENSE FLAGS WHITELIST = "commercial hello 1.0" 


你 在 构建 环境 的 conf/local.conf 中 指定 LICENSE_FLAGS_WHITELIST， 或 者 甚至 更 好 ， 在 例如 定制 层 的 conf/distro/mydistro.conf 的 友 行 版 配置 文 
件 中 指定 。 


12.1.4 许可 部 署 
当 构 建 目标 时 ， 构 建 系统 把 许可 信息 放 在 构建 环境 内 的 TMPDIR}/deploy/licenses 目 录 中 。 对 每 个 构建 系统 构建 的 菜谱 ， 它 在 
$fTMPDIR}/deploy/licenses 中 创建 一 个 子 目 录 : 
` 如 果菜 谱 构建 软件 包 ， 那 么 子 目 录 的 名 字 是 菜谱 的 名 字 ， 并 且 包 含 许可 文件 。 


. 如 果菜 谱 构 建 镜像 目标 ， 例 如 cote-image-minimal， 那 么 子 目 录 的 名 字 是 镜像 菜谱 的 名 字 并 带 有 一 个 增加 的 时 间 戳 ， 例 如 ，cote-image-minimal- 
20150817224402。 目 录 包 含 两 个 文件 : package.manifest 和 license.manifest。 前 者 是 按 字母 顺序 排列 的 、 包 含 在 镜像 中 的 所 有 包 名 的 列表 。 后 者 是 按 字母 顺 
序 排列 的 相同 的 包 并 带 有 包 名 、 包 版 本 、 菜 谱 名 字 以 及 许可 细节 的 列表 。 


` 如 果菜 谱 是 用 于 包 组 的 ， 那 么 构建 系统 以 包 组 的 名 字 创建 子 目录 ， 但 是 在 子 目录 中 没有 文件 。 

如 果 你 希望 为 你 的 目标 系统 部 署 许 可 信息 到 根 文 件 系 统 镜像 中 ， 那 么 
- 设置 变量 COPY_LIC_MANIFEST="1" 复 制 文件 license.manifest 到 根 文件 系统 中 ， 直 到 /ust/share/common-licenses/license.manifest。 
- 设置 变量 COPY_LIC_DIRS="1" 复 制 许 可 目录 到 /ust/share/common-licenses。 


你 在 构建 环境 的 conf/local.conf 中 指定 这 些 变量 ， 或 者 甚 全 更 好 的 是 ， 在 例如 定制 层 的 conf/distro/mydistro.conf 的 发 行 版 配置 文件 中 指定 。 


12.15 Bessa 


通过 将 变量 INCOMPATIBLE_LICENSE 设 置 为 空格 分 隔 的 许可 指派 的 列表 ， 你 可 以 把 菜谱 从 构建 中 排除 。 对 于 那些 它们 的 各 目 菜 谱 不 提供 对 列表 中 
的 许可 的 替代 性 许可 包 ， 构 建 系统 不 构建 它们 。 例 如 ,设置 


INCOMPATIBLE LICENSE = "GPL-3.0 LGPL-3.0 AGPL-3.0" 


有 效 地 把 所 有 以 这 些许 可 授权 的 包 从 构建 中 排除 ， 除 非 有 许可 奉 代 ， 它 可 能 是 使 用 不 同 许可 的 早期 版 本 或 者 提供 类 似 功 能 性 的 包 。 前 面 的 例子 代表 
了 Yocto 项 目 团队 用 其 来 测试 这 个 功能 性 的 设置 。 虽 然 你 可 以 使 用 其 他 设置 ， 但 是 你 可 能 需要 通过 移 除 它们 或 者 提供 替代 来 自己 处 理 依赖 性 以 生产 功能 系 
统 。 


12.1.6 提供 午 可 程序 清单 和 文本 


对 开源 许可 的 一 个 常见 需求 是 ， 你 必须 提供 许可 信息 。 使 用 
COPY_LIC_MANIFEST = "1" 


复制 许可 程序 清单 到 目标 镜像 的 目录 /usr/share/common-licenses/license.manifest 中 。 许 可 程序 清单 包含 已 安装 在 目标 上 的 所 有 开源 软件 包 及 其 
各 自 许 可 的 列表 。 


使 用 


COPY LIC DIRS = "1" 
也 复制 用 于 已 安装 在 目标 上 的 所 有 包 的 许可 文本 到 镜像 目标 的 目录 /usr/share/common-licenses 中 。COPY LIC_DIRS 仅 仅 可 以 和 
COPY LIC_MANIFEST 联 合 使 用 ; 否则 ， 设 置 变量 没有 效果 。 


对 具有 能 够 展示 许可 程序 清单 和 许可 文本 的 用 户 界 面 的 目标 系统 ， 把 它们 包含 在 目标 镜像 中 极 大 地 简化 了 这 部 分 开源 许可 的 合 规 性 。 如 果 你 的 诅 入 
式 目 标 没有 用 户 界 面 或 者 没有 足够 的 存储 空间 来 保存 许可 程序 清单 和 文本 ， 那 么 你 需要 以 替代 的 方法 提供 信息 ， 例 如 通过 打印 出 的 信息 或 者 在 你 组 织 网 
站 上 的 页 面 。 


12.3” 忆 结 


按照 开源 软件 包 各 自 许可 的 许可 要 求 来 进行 合 规 管 理 是 系统 构建 者 必须 要 执行 的 一 项 重要 任务 。 整 体 来 说 ， 因 为 用 于 嵌入 式 设 备 和 软件 产品 中 的 
Linux 和 开源 日 益 增 加 的 流行 度 ， 例 如 自由 软件 基金 会 (1] (Software Freedom Conservancy) 和 自由 软件 管理 机 构 [(2] (Software Freedom 
Conservancy) 的 多 个 组 织 正在 积极 监控 提供 包含 开源 软件 的 产品 的 公司 是 否 满足 各 种 开源 许可 (特别 是 GPL) 的 要 求 。 如 果 这 些 组 织 上 发现 一 个 公司 没 
有 遵守 许可 要 求 ， 那 么 他 们 将 要 求 其 弥补 这 个 情况 。 如 果 一 个 公司 不 做 任何 措施 ， 这 些 组 织 可 能 代表 相关 软件 包 的 作者 来 起 诉 该 公司 。 


尽管 开源 码 许可 是 宽容 的 ， 但 它们 是 具有 法 律 约束 力 的 文件 ， 因 此 可 以 由 法 律 强制 执行 。 最 好 遵守 合 规 要 求 来 避免 任何 问题 ， 并 且 在 交付 产品 前 计 
划 合 适 的 许可 文本 和 源 代码 的 上 友 布 。 


在 本 章 中 ， 我 们 讨论 了 : 
ATER: 通过 用 菜谱 追踪 许可 ， 创 建 商业 许可 的 包 及 其 各 自 菜谱 ， 以 及 收集 和 部 署 许可 信息 。 
.用 airchiver 类 实现 的 源 代码 管理 ， 这 提供 了 基于 许可 和 菜谱 类 型 控制 源 代码 打包 的 便利 方法 。 


[1] www.fsf.org. 


[2] https://sfconservancy.org. 
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YoctomBFA ARF, www.yoctoproject.org/docs/1.8/dev-manual/dev-manual.html, 


在 本 章 中 ， 我 们 讨论 精 选 的 主题 ， 它 们 促进 在 团队 或 者 生产 环境 中 使 用 Yocto 项 目 。Yocto 项 目 构建 系统 的 一 个 强大 之 处 是 ， 它 可 以 轻松 部 署 到 软件 
和 构建 工程 师 的 个 人 开 友 系统 上 。 本 章 中 讨论 的 特性 会 扩展 构建 系统 的 能 力 ， 使 得 你 共享 资源 和 追踪 构建 结果 ， 这 对 团队 开 有 友和 在 生产 环境 中 要 求 再 现 
性 (reproducibility) 、 一 致 性 和 可 重复 性 来 说 是 必要 的 。 


13.1 Toaster 


Toaster 是 构建 系统 的 一 个 图 形 用 户 界面 。 不 像 Hob，Hob 是 原生 应 用 ，Toaster 是 通过 Web 浏 览 器 访问 的 Web 界 面 。 因 为 它 是 Web 界 面 ， 所 以 
Toaster 适 合 部 署 在 构建 集群 和 云 服务 中 的 远程 系统 上 。 


与 Hob 相 似 ，Toaster 人 允许 你 配置 、 启 动 和 监控 构建 。Toaster 也 提供 搜索 以 及 向 你 的 构建 增加 元 数据 层 和 菜谱 的 功能 性 。 自 从 Yocto 项 目 版 本 1.8 
Fido 开 始 ，Hob 已 经 被 Yocto 项 目 团 队 官方 痉 用 了 ， 并 且 开 发 也 已 经 停止 ， 取 而 代 之 的 是 Toaster。 


用 Toaster 工 作 要 比 用 Hob 工 作 稍微 复杂 一 点 儿 ， 因 为 它 要 求 用 于 Web 服 务 器 环境 的 额外 设置 。Toaster 使 用 Djangol'1jWeb 框 架 。Django 是 完全 用 
Python 编写 的 高 层级 Web 框 架 。Django 利 用 对 象 关系 映射 (Object-Relational Mapping, ORM) 用 于 数据 库 支撑 的 对 象 存储 。Toaster 使 用 ORM 在 
数据 库 中 存储 构建 统计 和 其 他 数据 ， 这 人 允许 在 后 续 构 建 间 容 易 的 比较 。 数 据 库 系 统 可 以 是 任何 Django 支 持 的 关系 型 数据 库 管理 系统 (Relational 
Database Management System, RDBMS) 。 黑 认 情 况 下 ， 对 于 本 地 使 用 ，Toaster 为 了 简单 性 而 使 用 SQLite。 对 于 在 远程 构建 服务 器 上 的 部 署 ， 我 
们 推荐 使 用 实际 的 关系 型 数据 库 管 理 系统 ， 例 如 MySQL、MariaDB 或 者 PostgreSQL。 


在 接 下 来 的 部 分 ， 我 们 讨论 两 种 Toaster 操 作 模 式 ， 两 种 模式 下 本 地 开发 的 设置 ，Toaster 配 置 以 及 用 Toaster 设 置 一 个 生产 构建 系统 。 


[1] https://www.djangoproject.com. 


13.1.1 Toaster 操 作 模 式 \ 
你 可 以 以 分 析 模 式 或 者 构建 模式 两 者 之 一 来 运行 Toaster。 
分 析 模 式 


在 分 析 模 式 中 ，Toaster 附 加 到 你 以 前 用 oe-init-build-env 构 建 的 现 有 构建 环境 上 。 在 这 个 模式 中 ， 你 直接 使 用 bitbake 命 令 开始 构建 镜像 。 然 后 
Toaster 收 集 构建 统计 和 其 他 信息 ， 把 它们 存储 在 数据 库 中 ， 并 且 使 得 它们 可 用 于 在 Web 界 面 中 浏览 和 查看 。 在 通过 BitBake 启 动 你 的 构建 之 前 ， 你 需 
首先 启动 Toaster。 


在 分 析 模 式 中 ，Toaster 提 供 以 下 的 功能 性 : 

` 包括 菜谱 和 包 在 内 的 关于 构建 的 镜像 的 细节 信息 。 
- 关于 什么 包 已 经 被 安装 进 镜像 中 的 程序 清单 。 

` 浏览 镜像 目 隶 结构 的 能 力 。 

` 包括 变量 设置 在 内 的 构建 配置 。 


-检查 错误 、 警 告 和 日 志 消息 以 促进 调试 。 


-关于 任务 执行 和 共享 状态 使 用 的 信息 。 

. 依赖 性 浏览 器 。 

+ 例如 构建 时 间 、 每 个 任务 的 时 间 、CPU 使 用 率 等 的 性 能 信息 。 
构建 模式 


在 构建 模式 中 ，Toaster 创 建构 建 环境 并 且 管 理 配置 、BitBake 执 行 以 及 分 析 模 式 下 的 数据 收集 和 分 析 任务 。 你 仪 仪 通过 Toaster 的 Web 界 面 与 其 交 
互 。 从 Toaster 界 面 中 ， 你 可 以 选择 镜像 ， 配 置 目 标 机 器 和 构建 的 其 他 方面 ， 并 且 局 动 构建 。 你 不 直接 和 BitBake 交 互 ， 而 是 当 Toaster 在 分 析 模 式 时 ， 你 
直接 和 BitBake 交 互 。 


在 构建 模式 中 ， 除 了 分 析 模 式 的 功能 性 以 外 ，Toaster 也 提供 了 以 下 功能 性 : 
` 浏览 层 并 且 添 加 层 到 构建 配置 。 

选择 目标 镜像 、 目 标 机 器 和 发 行 版 策略 。 

检查 和 设置 配置 变量 。 

` 执行 构建 。 


在 构建 模式 中 ，Toaster 提 供与 Hob 不 相 上 下 的 配置 和 执行 功能 性 。 用 Toaster 通 过 向 镜像 中 增加 包 来 配置 镜像 不 像 Hob 那 样 方便 ， 因 为 它 要 求 你 从 
Toaster 用 户 界面 中 编辑 IMAGE _ INSTALL append 变 量 。 使 用 Hob， 它 仅 仪 是 选中 多 选 框 。 与 Hob 相 比 ，Toaster 提 供 了 更 详细 的 构建 分 析 和 统计 。 


13.1.2 Toasteng A 


Toaster 是 基于 Django Web 框 架 的 ， 因 此 要 求 安装 一 些 额外 的 Python 包 ， 然 后 你 才 可 以 使 用 它 。 你 可 以 在 已 经 安装 了 构建 系统 的 根 目录 (Gl 
如 /home/myname/poky) 的 bitbake/toaster-requirements.txt 文 件 中 找到 包 的 列表 。 可 以 直接 使 用 这 个 文件 来 安装 需 要 的 Python 包 。 


你 可 以 直接 安 委 那些 包 到 构建 主机 的 Python 库 目 录 中 ， 或 者 你 可 以 使 用 Python 虚拟 环境 (virtual environment) 。Python 虚 拟 环境 基于 构建 主机 
上 的 原始 Python 设置 来 创建 Python 沙 例 。 如 果 你 对 冲突 的 版 本 有 所 顾虑 ， 那 么 这 是 特别 有 用 的 。 我 们 强烈 推荐 使 用 Python 虚拟 环境 。 


设置 Python 虚拟 环境 


你 用 virtualenv 命 令 设 置 Python 虚 拟 环境 ， 所 有 Linux 发 行 版 作为 一 个 包 来 提供 virtualenv 命 令 。 如 果 它 还 没有 安装 在 你 的 构建 主机 上 ， 那 么 对 
Fedora 或 者 Red Hat 系 统 ， 你 可 以 使 用 以 下 命令 来 安装 它 : 


S sudo dnf install python-virtualenv 
或 者 对 Ubuntu 系统 ， 使 用 : 
9 sudo apt-get install python-virtualenv 
然后 你 可 以 用 以 下 命令 创建 Python 虚拟 环境 : 
S virtualenv pvenv 


命令 在 当前 位 置 的 名 为 pvenv 的 目录 中 创建 新 的 Python 虚拟 环境 。 然 后 它 把 所 有 必要 文件 从 构建 主机 的 Python 环境 中 复制 到 新 的 虚拟 环境 中 。 在 构 
建 主 机 上 创建 Python 虚拟 环境 的 位 置 是 无 天 紧要 的 。 


在 你 可 以 使 用 Python 虚 拟 环境 之 前 ， 你 必须 用 以 下 命令 来 激活 它 : 


S source pvenv/bin/activate 
(pvenv) 5 


为 了 标示 你 正在 工作 于 Python 虚 拟 环境 ， 你 的 命令 行 提示 被 前 缀 以 在 括号 内 的 虚拟 环境 的 名 字 ， 在 我 们 例子 中 是 (pvenv) . 
你 必须 从 活动 的 Python 虚 拟 环 境内 执行 所 有 与 Toaster 相 关 的 操作 ， 包 括 所 需 Python 包 的 安 闪 ;否则 ， 你 的 构建 主机 使 用 它 默 认 的 Python 环 境 。 


当 在 Python 虚 拟 环境 中 时 ， 你 输入 以 下 命令 退出 Python 虚 拟 环境 : 


(pvenv) $ deactivate 


安装 Toaster 需 求 


从 Python 虚拟 环境 内 ， 执 行 : 


(pvenv) $ pip install -r bitbake/toaster-requirements.txt 


把 需要 的 Python 包 (包括 Django) 安装 进 Python 虚 拟 环 境 中 。 


现在 你 的 构建 主机 已 经 准备 好 用 于 本 地 Toaster 开 友 了 。 


13.1.3 ”本 地 Toaster 开 发 


在 本 地 开发 模式 中 ，Toaster 使 用 Django 内 置 的 Web 服 务 器 而 不 是 与 外 部 Web 服 务 器 集成 ; 它 使 用 SQLite 而 不 是 RDBMS， 这 极 大 地 简化 了 安装 和 
配置 。 然 而 ， 对 于 工作 组 使 用 和 远程 部 署 来 说 ， 它 不 能 伸缩 。 对 于 可 伸缩 的 部 署 来 说 ， 你 应 该 考虑 使 用 Toaster 生 产 设置 ， 正 如 在 13.1.5 小 节 中 所 描述 
的 。 


构建 模式 下 的 本 地 Toaster 开 发 


在 活动 的 Python 虚拟 环境 内 ， 改 变 到 你 的 构建 系统 安 半 的 根 目录 中 ， 例 如 ， 


(pvenv) $ cd /home/myname/poky 


然后 ， 用 如 下 命令 启动 Toaster: 

(pvenv) $ bitbake/bin/toaster 

如 果 这 是 你 第 一 次 局 动 Toaster， 那 么 它 初 始 化 数据 库 ， 读 取 层 和 构建 系统 配置 ， 并 且 执 行 一 系列 其 他 初始 设置 任务 。 一 旦 设置 完成 ，Toaster 打 印 
ae 


Starting webserver... 

Webserver address: http://0.0.0.0:8000/ 

Starting browser... 

Toaster is now running. You can stop it with Ctrl-C 


你 的 构建 主机 的 默认 Web 浏 览 器 应 该 目 动 局 动 了 ， 并 且 显 示 Toaster 登 录 页 面 。 如 果 Web 浏 览 器 没有 目 动 启动 ， 那 么 打开 你 喜欢 的 Web 浏 览 器 ， 并 
且 在 导航 栏 中 输入 : 


http://localhost: 8000 


现在 你 可 以 创建 Toaster 项 目 、 配 置 它 并 且 构 建 它 。 
分 析 模 式 下 的 本 地 Toaster 开 发 

如 果 你 希望 使 用 Toaster 用 于 现 有 的 构建 环境 并 且 通 过 直接 调用 BitBake 来 控制 构建 过 程 ， 那 么 首先 从 Python 虚 拟 环 境内 引用 构建 环境 : 
(pvenv) $ source /home/myname/poky/oe-init-build-env tbuild 
然后 ， 首 先 从 Python 虚拟 环境 内 启动 Toaster: 

(pvenv) $ source /home/myname/poky/bitbake/bin/toaster 
现在 你 可 以 像 往常 一 样 运行 BitBake， 例 如 : 

(pvenv) $ bitbake -k core-image-base 

为 了 监控 构建 中 的 过 程 和 在 构建 已 经 完成 后 查看 构建 统计 等 ， 把 你 的 浏览 器 指向 到 : 
http://localhost: 8000 
从 Python 虚拟 环境 内 输入 以 下 命令 来 停止 Toaster : 

(pvenv) $ source /home/myname/poky/bitbake/bin/toaster stop 


这 终止 所 有 Toaster 进 程 。 


13.1.4 Toaster 四 0 秆 


Toaster 配 置 可 以 通过 命令 行 选项 、 环 境 变量 和 Django 管 理 用 户 界 面 来 配置 和 管理 。 
设置 不 同 端口 
默认 情况 下 ，Toaster 监 听 在 构建 主机 的 所 有 网 络 接口 的 8000 端 口 。 为 了 改变 问 口 ， 在 构建 模式 下 用 webport 人 参数 司 动 Toaster， 如 下 所 示 : 
(ovenv) $ /home/myname/poky/bitbake/bin/toaster webport=5000 
替代 性 地 ， 你 可 以 在 分 析 模 式 下 用 webport 参 数 启动 Toaster: 


(pvenv) $ source /home/myname/poky/bitbake/bin/toaster webport=5000 


然后 ，Toaster 监 听 所 有 网 络 接口 上 提供 的 端口 中。 
设置 用 于 构建 模式 的 Toaster 目 录 


在 构建 模式 下 ，Toaster 在 由 环境 变量 TOASTER _DIR 定 义 的 目录 中 存储 构建 环境 和 来 自 远程 仓库 的 额外 层 的 克隆 。 在 那个 目录 内 ，Toaster 创 建 目 录 
build， 它 包含 构建 环境 ; 创建 目录 toaster_clones， 它 包含 克隆 的 层 ; 创建 数据 库 toaster.sqlite， 它 存储 配置 和 构建 数据 。 上 默认 情 况 
下 ，TOASTER_DIR 被 设置 成 当前 目录 (Toaster 是 从 这 里 局 动 的 ) 。 


从 不 同 的 目录 启动 Toaster 是 设置 Toaster 目 录 的 唯一 方法 。 然 后 Toaster 创 建新 的 数据 库 ， 以 及 构建 和 层 目录 。 
管理 Django 框 架 


Toaster 构 建 在 Django Web 框 架 之 上 。Django Web 框 架 提 供 了 管理 用 户 界 面 ， 它 给 了 你 对 存储 在 数据 库 中 的 ORM 的 直接 访问 。 为 了 使 用 用 户 界 


面 ， 你 必须 首先 创建 Django 超 级 用 户 。 从 Python 虚拟 环境 内 ， 执 行 : 


(pvenv) $ /home/myname/poky/bitbake/lib/toaster/manage.py createsuperuser 


该 命令 启动 Django 管 理 实用 程序 ， 它 首先 询问 你 下 列 项 : 
` 超级 用 户 的 用 户 名 (必需 ) 

电子 邮箱 地 址 (可 选 ) 

密码 (必需; 你 必须 输入 2 次 以 验证 ) 


在 Django 创 建 了 超级 用 户 之 后 ， 你 可 以 像 往 常 一 样 用 以 下 命令 启动 Toaster: 


(pvenv) $ /home/myname/poky/bitbake/bin/toaster 


然后 通过 向 浏览 器 的 导航 栏 中 输入 以 下 地 址 来 访问 管理 用 户 界 面 : 


http://localhost:8000/admin 


从 管理 用 户 界 面 中 ， 你 可 以 浏览 Toaster ORM， 并 且 增 加 数据 库 条 目 等 。 
如 果 你 从 不 同 目录 启动 Toaster， 那 么 每 个 目录 都 包含 自己 的 toaster.sqlite 数 据 库 。 对 每 个 这 些 Toaster 环 境 ， 你 必须 分 别 创建 超级 用 户 。 
Toaster 管 理 提供 了 以 下 类 别 的 访问 : 


Auth: 定义 用 户 和 用 户 组 的 身份 验证 类 别 。 本 地 Toaster 配 置 除了 用 于 超级 用 户 之 外 不 再 使 用 这 个 功能 。 用 于 生产 的 Toaster 环 境 使 用 这 个 功能 来 和 


远程 以 及 多 个 用 户 共享 Toastet 示 例 以 控制 访问 。 


. Bldcontrol: 包含 关于 被 Toaster 使 用 的 构建 环境 的 信息 的 构建 控制 类 别 。 一 个 Toaster 实 例 可 能 控制 在 相同 构建 主机 上 的 多 个 构建 环境 ， 或 者 通过 网 
络 控制 在 不 同 构建 主机 上 的 多 个 构建 环境 。 对 于 本 地 开发 ， 通 常 仅 仅 有 一 个 构建 环境 。 


-Orm: 包含 关于 BitBake 版 本 、 层 源 、Yocto 项 目 发 布 和 Toastet 设 置 的 信息 的 对 象 关 系 模 型 。Toastet 设 置 包 含 各 种 BitBaike 变 量 ， 你 可 以 借 由 Toastet 用 


户 界 面 通过 点 击 Project Configutation 屏 幕 内 的 BitBake 变 量 来 设置 它们 。 
通 单 ， 你 不 需要 直接 访问 ORM ， 但 是 可 以 使 用 Toaster 用 户 界 面 进行 配置 。 


[1] 如果 你 熟悉 Django， 你 可 能 知道 Django 不 但 允许 你 设置 端口 而 且 也 允许 你 指定 网 络 接 口 。 当 前 对 Toastetr 来 说 ， 不 能 指定 网 络 接 口 。 


13.1.5 Toaster >p 


Toaster 的 生产 部 署 允 许 实例 在 多 个 及 远程 的 用 户 中 共享 。 为 了 伸缩 到 承载 多 个 用 户 访问 Toaster 服 务 的 负载 ，Toaster 使 用 外 部 Web 服 务 器 代替 
Django 的 内 置 Web 服 务 器 ， 并 用 RDBMS 代 蔡 SQLite。 生 产 部 署 也 通常 被 设置 成 构建 模式 而 不 是 分 析 模 式 。 正 如 我 们 已 经 看 到 的 ， 构 建 模式 允许 用 户 直 
接 从 Web 用 户 界面 中 创建 Toaster 项 目 并 且 启 动 构建 。 


用 于 Django 生 产 部 署 的 Web 服 务 器 首选 是 Apache。 对 于 RDBMS 来 说 ， 你 可 以 在 MySQL 和 PostgreSQL 之 间 选 择 。 你 选择 哪 一 个 可 能 依赖 于 你 的 喜 
好 以 及 过 去 的 经 验 。 对 这 个 例子 ， 我 们 选择 MySQL。 


几乎 所 有 Linux 发 行 版 都 已 经 用 MariaDB[I1 蔡 换 了 MySQL。MariaDB 是 MySQL 的 一 个 直接 可 用 的 替代 品 ， 它 是 由 原来 MySQL 的 开发 者 维护 的 。 即 
使 Linux 发 行 版 的 包 管 理 器 可 能 仍然 在 包 名 字 中 使 用 mysql， 但 是 它们 实际 上 安装 MariaDB。 


准备 生产 主机 


为 了 准备 用 于 Toaster 设 置 的 生产 系统 ， 执 行 下 面 的 步骤 : 


1. 为 Yocto 项 目 构 建 系 统 安 妆 先决 条 件 ， 正 如 第 2 章 中 所 摘 述 的 。 
2. 安 装 Apache Web 服 务 器 、MySQL (MariaDB) 及 开发 库 、Python 虚 拟 环境 和 Apache 的 Python 模块 。 


a. 企 Ubuntu 系统 上 : 


9 sudo apt-get install apache2 libapache2-mod-wsgi mysql-server \ 
Virtualenv libmysglclient-dev 


b. 在 Fedora 或 者 Red Hat 系 统 上 : 


S sudo dnf install httpd mod_wsgi python-virtualenv mysgl-server \ 
mysql mysgql-devel 


3. 启 动 Apache Web 服 务 器 。 
a. 企 Ubuntu 系统 上 : 
S sudo service apache2 start 
b. 在 Fedora 或 者 Red Hat 系 统 上 : 
S sudo systemctl start httpd 


通过 把 的 浏览 器 指向 生产 主机 来 验证 Web 服 务 器 是 否 正在 运行 。 你 应 该 看 到 默认 网 页 ， 网 页 的 内 容 依 赖 于 你 的 友 行 版 。 
4. 局 动 数据 库 服 务 器 。 


a. 企 Ubuntu 系统 上 : 
S sudo service mysql start 
b. 在 Fedora 或 者 RedHat 系 统 上 : 
9 sudo systemctl start mariadb 
5. 默 认 情况 下 ，MySQL (MariaDB) 没有 为 root 设 置 密码 。 为 了 第 一 次 设置 root 密 码 ， 执 行 以 下 命令 : 
S mysqladmin -u root password <rootpassword> 
6. 验 证 你 可 以 登录 进 MySQL (MariaDB) 服务 器 : 
$ mysql -u root -p 
数据 库 应 该 询问 你 在 前 面 步 又 设置 的 密码 ， 然 后 显示 命令 提示 符 。 


7. 为 Toaster 准 备 MySQL 数 据 库 : 


S mysql -u root -p 

mysql> CREATE USER 'toaster'@'localhost' identified by 'password'; 
mysql> CREATE DATABASE toaster; 

mysql> GRANT all on toaster.* to 'toaster'@'localhost'; 

mysql> exit 


你 的 生产 主机 现在 已 经 准备 好 用 于 Toaster 的 安装 和 配置 了 。 


Toaster 的 安 半 和 配置 


对 生产 配置 ， 作 为 Poky 构 建 系统 一 部 分 的 Toaster 最 理想 的 是 被 安装 到 Apache Web 服 务 器 的 文档 根 目 录 ， 这 人 允许 更 简单 的 应 用 Apache 访 问 规则 层 
级 结构 。 通 种 ， 那 个 目录 是 va/www。 你 可 以 安 委 到 不 同 的 目录 ， 但 是 你 需要 对 应 地 调整 Apache 配 置 。 执 行 以 下 步骤 来 在 你 的 生产 主机 上 安 妆 和 配置 


Toaster: 


1. 在 Web 服 务 器 文档 根 目 录 中 创建 一 个 目录 ， 并 且 安 装 Poky 构 建 系 统 。 我 们 正在 使 用 /vavwwwytoaster 作 为 安装 目录 和 Poky 的 Jethro 人 分支 : 


sudo mkdir /var/www/toaster 

cd /var/www/toaster 

sudo git clone git://git.yoctoproject.org/poky 
cd poky 

sudo git checkout jethro 


Ur Ur Ur Ur Ur 


2. 安 装 Toaster 和 Dijango Web 框 架 用 于 访问 MySQl 数 据 库 所 需要 的 Python 包 。 我 们 推荐 再 次 使 用 Python 虚拟 环境 来 隔离 Toaster 设 置 和 生产 主机 
的 Python 设置 。 


S cd /var/www/toaster 
S sudo virtualenv pvenv 


source pvenv/bin/activate 

sudo pip install -r poky/bitbake/toaster-requirements.txt 
sudo pip install mysql 

sudo pip install MySQL-python 


We Vous Us 


3. 通 过 按照 如 下 编辑 在 文件 /var/www/toaster/poky/bitbake/lib/toaster/toastermain/settings.py 中 的 配置 部 分 来 配置 Toaster: 


a. 修 改 用 于 MySQL 的 DATABASES 部 分 : 


DATABASES = { 


'default': { 
'ENGINE': 'django.db.backends.mysql', 
'NAME';: ‘toaster’, 


"USER SE "Oas ter"; 
'PASSWORD': 'password', 
"HOST'S “logalnogt y 
"POR. @ "2206". 


对 数据 库 NAME、USER 和 PASSWORD， 使 用 上 一 小 节 第 7 步 中 的 值 。 移 除 HOST 和 PORT 设置 以 使 用 UNIX 域 套 接 字 (UNIX domain socket) 来 访 
问 MySQL 数 据 库 ， 这 是 默认 的 情况 。 


b. 修 改 SECRET KEY 为 唯一 的 密 钥 : 

SECRET_ KEY = 'secretkey' 

你 可 以 使 用 OpenSSL 来 创建 任意 的 密 钥 。 下 面 的 命令 创建 16 个 字符 长 度 的 base64 编 码 的 密 钥 : 
S openssl rand -baes64 16 


Cc. 修 改 STATIC ROOTA 


STATIC_ROOT = '/var/www/toaster/static/ ' 


Django 和 Toaster 两 者 所 使 用 的 静态 服务 的 文件 (例如 HTML 和 JavaScript 文 件 ) 需要 由 Apache Web 服 务 器 提供 。 这 些 文件 被 收集 并 且 复 制 到 这 个 
目录 。 


d., 通 过 设置 BUILD_ MODE 为 下 面 的 值 来 启用 构建 模式 : 


BUILD_ MODE = True 


4 .创建 数据 库 方案 (schema) ， 加 载 默认 数据 并 且 收 集 静 态 服 务 文件 : 


9 cd /var/www/toaster/poky 
S ./bitbake/lib/toaster/manage.py syncdb 
S ./bitbake/lib/toaster/manage.py migrate 


$ TOASTER_DIR= pwd TOASTER_CONF=./meta-yocto/conf/toasterconf.json\ 
./bitbake/lib/toaster/manage.py checksettings 
S sudo ./bitbake/lib/toaster/manage.py collectstatic 


与 步骤 相 天 的 几 个 解释 是 恰当 的 : 


syncdb 和 migrate 命 令 创 建 数据 库 方案 。 它 们 也 安装 Django 的 身份 验证 ， 询 问 你 是 否 希 望 创建 用 于 访问 管理 用 户 界 面 的 超级 用 户 。 我 们 推荐 你 在 此 时 
这 样 做 。 替 代 性 地 ， 你 可 以 在 稍 后 创建 超级 用 户 ， 正 如 13.1.4 小 节 中 所 描述 的 。 


- checksettings 命 令 从 文件 poky/meta-yocto/conf/toastetrconf.json 中 加 载 Toaster 配 置 数据 。 这 个 文件 包含 默认 设置 以 及 关于 层 源 的 信息 。 
TOASTER_DIR 环 境 变量 决定 Toastet 在 哪里 创建 构建 环境 。 正 如 在 前 面 例子 中 所 看 到 的 ， 使 用 pwd 把 构建 环境 放 在 /vat/wwwyVtoastet/poky 目 录 ， 这 可 能 是 
不 可 取 的 ， 因 为 构建 环境 变 得 非常 大 。 你 可 以 指定 不 同 的 目录 一 一 只 要 保证 它 是 存在 的 并 且 对 运行 Toastet 构 建 的 用 户 来 说 是 可 写 的 。 


. collectstatic 命 令 获取 静态 服务 的 文件 ， 正 如 前 面 所 描述 的 。 不 像 其 他 命令 ， 你 必须 以 root 权 限 运 行 collectstatic， 除 非 你 改变 static 目 录 的 权限 。 
Web 服 务 器 配置 


这 个 步骤 把 Toaster 和 Apache Web 服 务 器 集成 起 来 。 在 你 生产 主机 的 Apache 配 置 目 录 中 ， 你 需要 一 个 Web 服 务 器 网 关 接 口 (Web Server 
Gateway Interface, WSGI) 配置 文件 。 


在 Ubuntu 和 Debian 系 统 上 ， 创 建文 件 : 
/etc/apache2/conf-available/toaster.conf 
在 Fedora 和 Red Hat 系 统 上 ， 创 建文 件 : 


/etc/httpd/conf.d/toaster.conf 


并 写 入 程序 清单 13-1 的 内 容 。 


程序 清单 13-1 WSGl 配 置 (toaster.conf) 


Alias /static /var/www/toaster/static 
<Directory /var/www/toaster/static> 
Order allow, deny 
Allow from all 
Require all granted 
</Directory> 


WSGIDaemonProcess toaster_wsgi \ 
python-path=/var/www/toaster/poky/bitbake/lib/toaster: \ 


/var/www/toaster/pvenv/1lib/python2.7/site-packages 
WSGIProcessGroup toaster_wsgi 


WSGIScriptAlias / \ 
"/var/www/toaster/poky/bitbake/lib/toaster/toastermain/wsgi.py" 


如 果 你 改变 了 例子 中 的 Poky 安 妆 位 置 或 Python 虚拟 环境 ， 那 么 确保 你 企 WsGIDaemonProcess 设 置 中 对 应 地 调整 了 它们 。 


在 Ubuntu 和 Debian 系 统 上 ， 你 需要 用 以 下 命令 显 式 地 启用 WSGI 模 块 和 Toaster 配 置 : 


S sudo a2enmod wsgi 
S sudo a2Zenconf toaster 


这 个 步骤 在 Fedora 和 Red Hat 系 统 上 是 不 需要 的 。 


最 后 ， 你 需要 重启 Apache Web 服 务 器 。 在 Ubuntu 和 Debian 系 统 上 ， 使 用 以 下 命令 : 


9 sudo service apache2 restart 
在 Fedora 和 Red Hat 系 统 上 ， 使 用 以 下 命令 : 


9 sudo systemctl restart httpd 


现在 ， 在 你 浏览 器 的 导航 栏 中 输入 你 生产 主机 的 主机 名 或 者 I|P 地 址 ， 你 应 该 看 到 Toaster 登 录 页 面 。 如 果 你 得 到 错误 消息 ， 那 么 参考 Apache Web 服 
务 器 的 日 志文 件 以 获得 关于 错误 的 根本 原因 的 信息 一 一 在 Ubuntu 和 Debian 系 统 上 ， 它 是 在 /var/log/apache2 目 录 中 ; 在 Fedora 和 Red Hat 系 统 上 , É 
是 在 /var/log/httpd 目 录 中 。 


安装 构建 运行 服务 
构建 运行 服务 需要 运行 以 执行 构建 。 服 务 用 bblayers.conf 和 local.conf 的 配置 设置 来 创建 Yocto 项 目 构建 环境 ， 并 且 用 已 提供 的 镜像 目标 来 执行 


BitBake。 为 了 启动 构建 运行 服务 ， 使 用 以 下 命令 : 


S source /var/www/toaster/pvenv/bin/activate 
(pvenv) $ /var/www/toaster/poky/bitbake/lib/toaster/mangage.py runbuilds 


你 可 能 希望 把 上 面 的 命令 包 进 一 个 简单 的 shell 脚 本 中 以 简化 执行 ， 正 如 程序 清单 13-2 所 示 的 。 
程序 清单 13-2 Toaster 构 建 运行 shell 脚 本 (toasterbuildrunner.sh) 


#!/bin/sh 

# Launch Toaster Build Runner on a production host 
pushd /var/www/toaster 

source ./pvenv/bin/activate 
./poky/bitbake/lib/toaster/manage.py runbuilds 


不 要 以 root 运 行 构建 运行 服务 。 构 建 运行 服务 执行 BitBake，BitBake 拒 绝 以 root 权 限 运 行 。 在 安 半 和 配置 Toaster 时 ， 确 保 运行 构建 运行 服务 的 用 户 
对 你 用 TOASTER_DIR 指 定 的 目录 拥有 完全 的 访问 。 


现在 你 可 以 从 Toaster Web 用 户 界面 中 启动 构建 。 
维护 你 的 Toaster 生 产 实 例 


为 了 使 你 的 Toaster 生 产 实例 总 是 保持 最 新 的 ， 你 需要 有 规律 地 更 新 数据 库 中 的 层 源 信息 。 这 保证 你 总 是 对 最 新 的 层 和 菜谱 拥有 访问 。 为 了 加 载 最 新 
的 层 信息 到 Toaster 数 据 库 中 ， 使 用 命令 : 


S /var/www/toaster/poky/bitbake/lib/toaster/manage.py lsupdates 


为 了 更 新 你 的 生产 Toaster 实 例 到 Yocto 项 目的 一 个 更 新 的 版 本 ， 使 用 以 下 命令 : 


cd /var/www/toaster/poky 

git pull 

git checkout <branch> 

TOASTER_DIR= pwd TOASTER_CONF=./meta-yocto/conf/toasterconf.json \ 
./bitbake/lib/toaster/manage.py checksettings 

S sudo ./bitbake/1lib/toaster/manage.py collectstatic 


Ur Tt YY Ur 


运行 checksettings 用 来 自 toasterconf.json 文 件 的 更 新 的 发 布 和 层 信 息 来 填充 数据 库 。 执 行 collectstatic 保 证 用 户 界面 更 新 是 对 Web 服 务 器 可 用 
的 。 在 更 新 后 ， 确 保重 局 Web 服 务 器 。 


[1] https:/ /mariadb.orgo 


13.1.6 Toaster Web 用 户 界 面 


Toaster Web 用 户 界 面 提 供 以 下 的 功能 性 : 


MASE: 创建 、 配 置 和 查看 Toastet 项 目 。Toastet 项 目 类 似 于 通过 命令 行 引 用 oe-init-build-env 创 建 的 构建 环境 。Toastet 为 你 创建 和 管理 环境 。 对 项 
目 ， 你 选择 希望 使 用 其 来 构建 项 目的 Yocto 项 目 发 布 。 


. 构建 配置 : 在 Toastet 项 目 内 ， 你 可 以 配置 机 器 、 发 行 版 和 其 他 设置 ， 正 如 你 通过 编辑 构建 环境 的 conf/local.conf 文 件 所 做 的 。Toaster 用 户 界 面 提供 
对 常见 配置 变量 的 直接 访问 ， 例 如 DISTRO、IMAGE_FSTYPES、IMAGE_INSTALL append、PACKAGE_CLASSES 和 SDKMACHINE。 你 可 以 按照 你 希 


望 的 增加 其 他 变量 。 然 而 ， 一 些 变量 是 被 排除 的 。 这 些 变量 是 那些 影响 构建 主机 的 配置 和 设置 到 构建 制品 存储 位 置 的 路 径 的 变量 ， 例 如 SSTATE_DIR 和 
工 MPDTIR 。 
- 层 管理 : Toastetr 允 许 你 向 你 的 项 目 增加 层 和 去 除 层 。 你 也 可 以 浏览 可 用 层 的 列表 。meta、 yocto 和 yocto-bsp 这 3 个 层 是 默认 包含 在 项 目 中 的 ， 并 且 被 


自动 从 Poky 仓 库 中 检 出 。 来 自 OpenEmbedded 层 索引 中 关于 层 的 信息 是 直接 从 网 页 中 获取 的 并 且 被 显示 在 Toaster 用 户 界面 中 。 通 过 简单 地 单 击 按钮 ， 你 即 
可 增加 那些 层 到 你 的 项 目 中 。 这 些 层 是 按 需 从 OpenEmbedded 层 仓库 中 检 出 的 。 另 外 ， 你 可 以 从 Git 仓 库 中 导入 自己 的 层 。 你 需要 保证 你 正在 导入 的 层 与 
你 为 项 目 选择 的 Yocto 项 目 发 布 是 兼容 的 。 


. 镜像 目标 : Toastet 从 各 种 可 用 层 中 识别 和 列 出 镜像 目标 。 如 果 镜 像 目 标 是 从 一 个 你 构建 配置 所 包含 的 层 中 可 用 的 ， 那 么 你 可 以 通过 单 击 镜像 目标 
F A Build tecipe 按 钮 来 直接 构建 它 。 和 否则 ， 单 击 Add layet 按 钮 以 增加 层 到 你 的 构建 配置 中 。 如 果 层 依赖 于 其 他 的 层 ， 那 么 Toastet 把 依赖 性 通知 给 你 ， 并 
且 自 动 包含 它们 。 


. ARIE: Toastet 维 护 所 有 层 的 所 有 菜谱 列表 ， 不 管 它们 是 经 被 你 的 构建 所 包含 。 搜 索 功 能 帮助 寻找 特定 的 菜谱 。 例 如 ， 在 搜索 栏 中 输入 jdk 列 
出 所 有 提供 JavaJDK 的 菜谱 。 单 击 按钮 ， 你 可 以 增加 包含 菜谱 的 层 并 且 构 建 它 。 然 而 ， 构 建 菜谱 不 自动 增加 它 到 IMAGE_INSTALL。 你 必须 通过 编辑 
BitBake 变 量 屏 幕 上 的 IMAGE _INSTALL append 变 量 来 显 式 地 增加 它 。 


. 构建 日 志 : 你 可 以 直接 从 Toastet 用 户 界 面 中 查看 和 检查 追踪 、 警 告 及 错误 消息 。 你 也 可 以 从 Toastet 中 下 载 构建 日 志 到 你 的 本 地 机 器 。 
: 构建 统计 和 性 能 信息 : Toaster 收 集 例如 全 局 构建 时 间 、 每 个 任务 的 时 间 、CPU 使 用 率 和 硬盘 输入 输出 等 构建 统计 。 


PRES: Toaster 收 集 和 展示 关于 什么 包 已 经 被 构建 并 且 被 包含 在 镜像 中 的 信息 。 你 可 以 从 Toaster 用 户 界面 中 浏览 镜像 的 结构 并 查看 菜谱 和 包 之 
间 的 依赖 性 关系 。 


虽然 Toaster 人 允许 你 选择 和 构建 特定 菜谱 并 且 包 含 它 到 你 的 镜像 中 ， 但 如 果 一 个 层 为 一 个 菜谱 提供 了 多 个 版 本 ， 那 么 你 不 能 直接 选择 一 个 菜谱 的 特定 
版 本 来 构建 。 通 单 ， 正 如 我 们 前 面 所 看 到 的 ， 构 建 系统 选择 一 个 菜谱 的 最 新 版 本 。 例 如 ， 如 果 Linux Yocto 内 核 的 最 新 版 本 是 4.1， 但 是 你 想 构建 版 本 
3.9， 你 需要 增加 


PREFERRED_VERSION_linux-yocto = "3.9%" 


到 Toaster 用 户 界面 的 变量 配置 中 。 


Yocto 项 目 Toaster 团 队 已 经 制造 了 一 系列 涵 兰 Toaster 各 个 方面 的 指导 性 视频 。 你 可 以 在 www.youtube.com 上 找到 这 些 视 频 。 仅 仅 输 入 Yocto 
Project Toaster 到 YouTube 搜 索 栏 中 。 


13.2 构建 历史 


由 构建 系统 处 理 的 相当 多 的 菜谱 和 配置 文件 决定 什么 包 被 构建 、 它 们 如 何 被 构建 、 它 们 如 何 互相 依赖 以 及 最 终 完成 的 输出 制品 包含 什么 。 那 些 输 出 
包括 但 不 限于 二 进 制 包 、 内 核 和 根 文 件 系统 镜 像 以 及 软件 开 发 工具 包 (Software Development Kit, SDK) 。 伴 随 着 这 么 多 影响 构建 的 因素 ， 在 构建 间 
维护 可 重复 性 和 一 致 性 以 及 追 味 和 审计 变更 的 能 力 是 一 个 强 需 求 。 


考虑 升级 软件 包 到 新 版 本 。 如 果 那 个 软件 包 包 依 赖 于 一 个 新 版 本 的 库 ， 而 这 个 库 是 与 很 多 其 他 包 所 共享 的 ， 那 么 看 起 来 足够 简单 的 东西 会 有 重要 的 
影响 。 在 这 种 情况 下 ， 构 建新 版 本 的 软件 包 目 动 拉 取 新 版 本 的 库 ， 如 果 那 个 库 不 是 向 后 兼容 的 ， 那 么 这 可 能 对 其 他 软件 包 造 成 问题 。 


构建 系统 的 构建 历史 功能 为 维护 构建 质量 提供 了 自动 的 支持 ， 这 是 通过 以 下 来 完成 的 : 记录 关于 包 、 镜 像 科 SDK 构建 的 核心 信息 ; 在 文件 中 存储 人 它 
fJ; 以 及 提交 那些 文件 到 Git 仓 库 中 以 创建 可 追踪 的 历史 。 构 建 历史 是 由 buildhistory 类 实现 的 ， 该 类 是 由 所 有 菜谱 全 局 性 地 继承 的 。 它 的 行为 是 由 几 个 
配置 变量 控制 的 ， 这 些 变 量 允 许 你 定义 构建 历史 存储 在 哪里 ， 从 什么 构建 制品 中 收集 信息 等 。 


13.2.1 局 用 构建 历史 
构建 历史 默认 是 禁用 的 。 你 必须 通过 增加 它 到 你 构建 环境 的 conf/local.conf 中 的 INHERIT 变 量 中 以 启用 它 : 


INHERIT += "buildhistory" 
BUILDHISTORY_COMMIT = "1" 


第 一 条 语句 局 用 buildhistory 类 ， 它 为 所 有 菜谱 收集 构建 新 型 。 第 二 条 语句 局 用 提交 所 有 对 构建 历史 的 变更 到 Git 仓 库 。 如 果 你 仅仅 对 收集 关于 最 后 
构建 的 信息 感 兴趣 ， 那 么 你 可 以 通过 设置 BUILDHISTORY COMMIT= "0" 来 禁用 提交 到 Git 仓 库 。 


构建 历史 是 累积 的 ， 这 意味 着 仪 仪 收集 那些 企 构建 过 程 中 已 经 执行 了 的 菜谱 及 其 任务 的 信息 。 其 他 隐 含 着 ， 如 果 你 正在 寻找 完整 的 构建 历史 ， 那 么 
你 必须 在 局 动 第 一 次 构建 之 前 就 为 你 的 构建 环境 启用 它 。 


13.2.2 ”配置 构建 历史 


你 可 以 通过 一 组 配置 变量 来 调整 构建 历史 的 行为 : 


- BUILDHISTORY_DIR: 这 个 变量 指定 到 buildhistory 类 存储 构建 历史 信息 所 在 位 置 的 路 径 。 上 默认 设置 是 BUILDHISTORY_DIR? 
="${TOPDIR}/buildhistory。 如 果 BUILDHISTORY_COMMIT 是 启用 的 ， 那 么 buildhistory 类 在 那个 位 置 创建 Git 目 录 。 使 用 这 个 交 量 来 迁移 构建 历史 。 


- BUILDHISTORY COMMIT: 这 个 变量 控制 构建 历史 是 否 提交 到 位 于 BUILDHISTORY_DIR 内 的 本 地 Git 仓 库 中 。 如 果 这 个 变量 第 一 次 用 于 现 有 构 
建 历 史 ， 那 么 buildhistorty 类 初始 化 在 BUILDHISTORY_DIR 中 的 Git 仓 库 。 在 每 次 完成 BitBake 运 行 后 ， 对 构建 历史 的 变更 被 提交 到 仓库 。 如 果 你 希望 追踪 对 


构建 历史 的 变更 ， 那 么 设置 BUILDHISTORY_COMMIT='"1"。 默 认 设 置 是 BUILDHISTORY_COMMIT?="0"。 


- BUILDHISTORY_ COMMIT _AUTHOR: 当 使 用 Git 仓 库 来 追踪 随时 间 演 变 而 产生 的 构建 历史 变更 时 ， 变 量 提供 一 个 用 于 提交 到 仓库 的 Git 用 户 名 。 
Git 有 要求 这 个 变量 的 值 的 形式 是 name<emailC@domain>。 这 个 变量 的 默认 设置 是 BUILDHISTORY_COMMIT AUTHOR 


="buildhistory<buildhistory@${DISTRO}>。 只 有 在 BUILDHISTORY_COMMIT 设 置 成 "1" 时 ， 这 个 变量 的 设置 才 起 作用 。 
- BUILDHISTORY FEATURES: buildhistory 类 为 以 下 不 同类 别 收集 分 析 数 据 : 
‘image (镜像 ) : 包含 已 安装 包 在 内 的 镜像 内 容 的 分 析 数 据 。 
- package 〈 包 ) : 各 个 包 内 容 的 分 析 数 据 。 
‘sdk: SDK 内 容 的 分 析 数 据 。 
你 可 以 以 一 个 空格 分 隔 的 列表 来 指定 这 些 类 别 的 任意 组 合 。 默 认 值 是 BUILDHISTORY FEATURES?="image package sdk", 


- BUILDHISTORY_IMAGE FILES: 这 个 变量 指定 空格 分 隔 的 路 径 列 表 ， 该 路 径 指向 安装 在 根 文件 系统 镜像 中 的 文件 ， 以 便 你 可 以 追踪 文件 的 内 
容 。 对 系统 和 应 用 配置 文件 来 说 ， 这 尤其 有 用 。 上 默认 设置 是 BUILDHISTORY_IMAGE_FILES?="/etc/passwd/etc/group"， 这 允许 你 追踪 对 用 户 和 组 条 目的 
变更 。buildhistory 类 使 用 cp 命令 来 把 文件 从 镜像 根 复 制 到 构建 历史 目录 。 你 可 以 将 通配符 用 于 路 径 的 最 后 片段 来 用 变量 中 的 单一 条 目 复制 多 个 文件 。 然 
而 ， 子 目录 不 是 递归 复制 的 。 例 如 ， 使 用 BUILDHISTORY_IMAGE_FILES="/etc/*" 复 制 所 有 在 /etc 下 的 文件 但 不 包括 子 目录 。 你 需要 显 式 地 指定 那些 项 
望 复制 的 子 目 录 。 


- BUILDHISTORY_PUSH_REPO: 当 使 用 Git 仓 库 来 追踪 变化 (这 是 非常 推荐 的 ) 的 时 候 ， 你 可 以 有 选择 地 指定 远程 Git 仓 库 以 在 构建 历史 已 经 被 提 
交 到 本 地 仓库 后 推送 构建 历史 到 Git 仓 库 服 务 器 。 为 了 使 BUILDHISTORY_PUSH_COMMIT 生 效 ， 变 量 BUILDHISTORY_COMMIT 必 须 被 设置 成 1。 对 变量 


的 默认 设置 是 BUILDHISTORY_PUSH_REPO?=""。 


13.2.3 ” 推 壕 构建 历史 到 Git 仓 库 服务 器 


除了 用 构建 主机 上 的 本 地 Git 仓 库 追 踪 构 建 历史 ， 推 送 所 有 变更 到 Git 仓 库 是 保证 构建 质量 和 维护 历史 的 重要 工具 。 昌 然 设置 基本 上 是 简单 直接 的 ,但 
是 我 们 把 这 个 部 分 专门 用 于 这 个 主题 是 因为 有 一 些 重要 的 事情 要 考虑 。 


为 了 演示 设置 ， 我 们 使 用 公共 GitHub 仓 库 服务 器 (1。 对 这 个 目的 而 言 ， 我 们 不 推荐 使 用 GitHub， 但 是 它 提供 了 测试 功能 性 的 简单 方法 ， 因 为 设置 
Git 仓 库 服务 器 不 在 本 书 的 范围 内 。 在 可 以 使 用 GitHub 之 前 ， 你 必须 创建 GitHub 账 号 ， 对 仅仅 托管 公共 仓库 的 账号 来 说 ， 这 是 免费 的 。GitHub 网 站 也 解 
释 了 该 过 程 。 然 后 ， 使 用 GitHub Web 用 户 界 面 创建 空 的 Git 仓 库 一 一 例如 ，yp_buildhistory。 不 要 创建 任何 文件 ， 也 不 要 对 仓库 做 初始 提交 。 第 一 次 提 
交 来 自 Yocto 项 目 构 建 。 


虽然 你 可 以 自由 地 读 取 和 克隆 在 GitHub 上 的 任何 公共 仓库 ， 但 是 推送 变更 到 仓库 需要 身份 验证 。 构 建 系统 使 用 安全 Shell (SSH) 来 推送 对 本 地 构建 
历史 Git 仓 库 做 出 的 变更 到 远程 Git 仓 库 。 当 使 用 SSH 时 ，GitHub 要 求 公 钥 基 础 实施 (Public Key Infrastructure, PKI) 用 于 身份 验证 。PKI 由 一 对 公 钥 
和 一 对 私 钥 组 成 。 你 在 构建 主机 上 创建 密 钥 对 并 且 上 传 公 钥 到 GitHub 上 。GitHub 对 如 何 完成 那个 任务 提供 了 好 的 指导 [站 。 当 创建 SSH 密 钥 时 ， 你 可 以 选 
择 使 用 密码 来 保护 私 钥 。 如 果 你 计划 用 Yocto 项 目 做 自动 化 的 构建 ， 那 么 不 推荐 这 么 多 ， 因 为 构建 系统 停止 执行 并 且 询 问 要 输入 的 密码 。 


一 旦 你 已 经 设置 了 GitHub 账 号 ， 增 加 了 SSH 公 钥 到 你 账号 ， 并 上 且 创建 了 仓库 ， 那 么 你 需要 设置 用 于 构建 环境 的 构建 历史 。 和 往常 一 样 ， 那 个 配置 是 
通过 设置 在 conf/local.conf 中 的 变量 来 完成 的 ， 正 如 程序 清单 13-3 所 示 。 


程序 清单 13-3 ”构建 历史 配置 (conf/local.conf) 


二 

# Build History Configuration 

二 

INHERIT += "buildhistory" 

BUILDHISTORY_COMMIT = "1" 

BUILDHISTORY_COMMIT_AUTHOR = "Santa Claus <santa.claus@northpole.com>" 
BUILDHISTORY_DIR = "S{TOPDIR}/../../yocto/buildhistory" 
BUILDHISTORY_IMAGE FILES = "/etc/passwd /etc/group" 

BUILDHISTORY_PUSH_REPO = "git@github.com:sclaus/yp_buildhistory.git master" 


用 于 BUILDHISTORY_PUSH_REPO 的 URL 当 然 依赖 于 远程 仓库 的 设置 。 在 例子 master 的 案例 中 ， 指 定 分 文 是 可 选 的， 但 要 求 分 广 已 经 仓 人 在 于 远程 仓 


库 中 ， 而 对 于 空 的 仓库 这 是 不 成 立 的 。 当 多 个 构建 环境 推送 构建 历史 到 相同 的 远程 仓库 时 ， 使 用 分 支 并 且 显 式 地 指定 它们 是 强烈 推荐 的 ， 这 人 允许 为 每 个 
构建 环境 使 用 不 同 的 分 支 。BitBake 变 量 扩展 适用 于 BUILDHISTORY_ PUSH REPO， 正 如 它 适用 于 任何 其 他 变量 一 样 。 这 意味 着 ， 你 可 以 使 用 例如 
${DISTRO} 的 变量 来 指定 分 支 。 


因为 构建 系统 总 是 提交 构建 历史 中 的 变更 到 主干 分 文 ， 所 以 你 手动 地 使 用 
9 git checkout -b <branchname> 


来 创建 和 切换 到 本 地 构建 历史 Git 仓 库 的 那个 分 文中 。 
在 那 之 后 ， 你 可 以 在 BUILDHISTORY_PUSH_REPO 中 使 用 branchname。 


[1] https://github.com. 


[2] https://help. github.com/articles/generating-ssh-keys o 


13.2.4 理解 构建 历史 


构建 历史 以 由 目录 和 文件 组 成 的 特定 结构 存储 在 BUILDHISTORY _DIR 之 下 ( 见 程 序 清单 13-4) 。 


程序 清单 13-4 ”构建 历史 结构 


$ tree -L 3 buildhistory 
buildhistory/ 

-— metadata-revs 

-— images 

| 一 qemux86_64 


L— glibc 

L— core-image-base 
~ build-id.txt 
L— depends.dot 
—— depends-nokernel.dot 
— depends-nokernel-nolibc.dot 
—-— depends-nokernel-nolibc-noupdate.dot 
—— depends-nokernel-nolibc-noupdate-nomodules.dot 
|- files-in-image. txt 
—-— image-files 
|- image-info.txt 
—— installed-package-names.txt 
-~ installed-package-sizes.txt 
L— installed-packages.txt 


L— ypbkiosk 


L— glibc 
—-— core-image-minimal-initramfs 
| -~ build-id.txt 
| —-— depends.dot 
| L— depends-nokernel.dot 
| —-— depends-nokernel-nolibc.dot 
| —-— depends-nokernel-nolibc-noupdate.dot 
| -~ depends-nokernel-nolibc-noupdate-nomodules.dot 
| — files-in-image.txt 
| —-— image-files 
| —-— image-info.txt 
| —— installed-package-names.txt 
| 广 - installed-package-sizes.txt 
| L— installed-packages.txt 
-一 ypbkiosk-image-sato 
~ build-id.txt 
六- depends.dot 
—— depends-nokernel.dot 
L— depends-nokernel-nolibc.dot 
六- depends-nokernel-nolibc-noupdate.dot 
—— depends-nokernel-nolibc-noupdate-nomodules.dot 
~- files-in-image.txt 
L— image-files 
-一 image-info.txt 
— installed-package-names.txt 
—— installed-package-sizes.txt 
L— installed-packages.txt 


— metadata-revs 
—-— packages 


-— all-poky-linux 
-~ adwaita-icon-theme 


— adwaita-icon-theme 
| | 一 latest 
| | 一 latest.pkg_postinst 


| | | | L— latest.pkg_postrm 

| | | 广 - adwaita-icon-theme-cursors 
| | | | | 一 latest 

| | | | | 一 latest.pkg_postinst 

| | | | L— latest .pkg_postrm 

| | | L— adwaita-icon-theme-hires 

| | | | | 一 latest 

| | | | | 一 latest.pkg_postinst 

| | | | [一 latest. pkg_postrm 


-— core2-64-poky-linux 


— acl 
— acl 
| | 一 files-in-package. txt 
| L— latest 
L— acl-dbg 


| 

| 

| 

| 

| | | 一 files-in-package.txt 
| | L— latest 

| L— acl-dev 

| | | 一 files-in-package. txt 
| | L— latest 

| L— acl-doc 

| | | 一 files-in-package.txt 
| | L— latest 


L— poky-glibc-x86_64-hagw-image-base-corei7-64 
L— hagw-image-base 
—  files-in-sdk.txt 
| 一 sdk-info.txt 
-— host 
| — depends.dot 
| — installed-package-names.txt 
| I— installed-package-sizes.txt 
| L— installed-packages.txt 
L— target 
广 - depends.dot 
— installed-package-names.txt 
— installed-package-sizes.txt 
L— installed-packages.txt 


位 于 顶级 的 是 用 于 通过 BUILDHISTORY_FEATURES 启 用 的 类 别 的 子 目 录 。 在 一 个 成 功 的 构建 完成 后 ， 用 于 镜像 和 包 特 性 的 子 目录 总 是 仔 在 的 。 用 于 
软件 开发 工具 包 特 性 的 子 目录 仅仅 在 你 已 经 用 -c populate _sdk 构 建 了 SDK 之 后 才 被 创建 和 填充 。 另 外 ， 构 建 历史 的 顶级 目录 也 包含 文件 metadata- 
revs， 它 包含 元 数据 层 的 修订 信息 ， 而 这 些 元 数据 层 是 在 构建 生产 时 由 构建 系统 所 使 用 的 。 


构建 历史 镜像 信息 


构建 历史 镜像 信息 正如 $DEPLOY_DIR}/image 目 录 中 的 镜像 一 样 是 按照 机 器 划分 类 别 的 。 在 那 之 下 是 一 个 名 为 C 库 的 子 目 录 。 除 非 你 正在 用 不 同 的 
C 库 构建 ， 否 则 那个 子 目 录 的 名 字 融 是 glibc。 在 C 库 子 目 录 下 ， 构 建 系统 为 每 个 镜像 目标 创建 一 个 子 目 录 ， 例 如 core-image-base。 在 镜像 目标 子 目 录 内 
是 包含 天 于 镜像 的 信息 的 各 种 文件 和 目录 : 


- build-id.txt: 用 到 的 构建 配置 ， 包 括 BitBake 版 本 、 构 建 主机 和 元 数据 层 版 本 等 。 

-depends.dot: 以 文本 的 DOT 格 式 表 现 的 完整 依赖 性 关系 图 ， 它 可 以 被 Graphviz 和 其 他 能 够 解析 DOT 格 式 的 软件 所 泻 染 。 
- depends-nokernel.dot: 和 前 面 一 个 相同 ， 但 不 包括 内 核 依 赖 性 。 

- depends-nokernel-nolibc.dot: 和 前 面 一 个 相同 ， 但 不 包括 C 库 依赖 性 。 

- depends-nokernel-nolibc-noupdate.dot: 和 前 面 一 个 相同 ， 但 不 包括 更 新 依赖 性 。 


- depends-nokernel-nolibc-noupdate-nomodules.dot: 和 前 面 一 个 相同 ， 但 不 包括 内 核 模块 依赖 性 。 


- files-in-image.txt: 镜像 中 的 所 有 文件 列表 ， 本 质 上 是 根 文件 系统 的 命令 find/l-path.-printf"9%M9%6-10u%-10g%10s%p\na" 输 出 。 
-image-files: 包含 由 BUILDHISTORY_IMAGE_FILES 指 定 的 文件 的 子 目录 。 

-image-info.txt: 直接 影响 镜像 的 内 容 和 大 小 的 变量 及 其 值 的 列表 。 

- installed-package-names.txt: 按照 字母 排序 的 、 安 装 在 镜像 中 的 所 有 包 名 的 列表 。 

- installed-package-sizes.txt: 按照 大 小 (从 大 到 小 ) 顺序 排列 的 、 安 装 在 镜像 中 的 所 有 包 的 列表 。 

- installed-packages.txt: 按照 字母 排序 的 、 安 装 在 镜像 中 的 所 有 包 的 完整 包 文件 名 的 列表 。 


市 有 概述 性 息 结 的 Image-info.txt 文 件 对 于 姐 踊 镜像 内 容 中 的 变更 提供 了 有 用 的 起 后。 存储 在 文件 中 的 变量 有 : IMAGE _CLASSES， 其 包含 用 于 创建 
镜像 的 类 的 列表 ; IMAGE INSTALL, IMAGE FEATURES 和 ROOTFS POSTPROCESS COMMAND, 它们 直接 参与 编译 根 文件 系统 的 内 容 。 


构建 历史 包 信 息 


针对 包 的 构建 历史 按照 染 构 被 组 织 进 子 目 录 中 并 且 包 含 为 构建 主机 和 目标 所 创建 的 包 。 架 构 子 目录 和 用 在 ${BASE_WORKDIR} 内 的 子 目 录 是 相同 
的 。 


每 个 包 都 有 自己 的 子 目录 ， 其 包含 名 为 latest 的 文件 和 用 于 每 个 在 包 拆 分 过 程 中 创建 的 安装 包 的 子 目 录 。 包 顶级 的 latest 文 件 包 含 包 版 本 (PV) 和 包 
修订 (PR) 信息 、 构 建 依赖 性 列表 (DEPENDS) 以 及 创建 的 安装 包 的 列表 (PACKAGES) 。 如 果 包 是 从 获取 上 自 版 本 控制 系统 (如 Git) 的 源 创 建 的 ， 那 
么 目录 也 包含 文件 latest srcrev， 它 包含 所 使 用 分 支 的 源 修订 的 列表 。 


每 个 安 和 包子 目录 包含 一 个 或 者 多 个 审 有 包 信息 的 文件 。 


-latest: 在 构建 中 决定 包 的 内 容 的 变量 及 其 值 的 列表 。 这 个 列表 包含 PV、PR、RPROVIDES、RDEPENDS、FILES 以 及 一 个 PKGSIZE 条 目 (以 KB 
为 单位 的 整个 包 的 大 小 ) 。 


- files-in-package.txt: 包含 在 包 中 的 所 有 文件 及 其 路 径 和 大 小 的 列表 。 
` latest.pkg *: 在 实施 特定 的 命令 之 前 或 者 之 后 ， 包 含 由 包 管 理 器 执行 的 任何 命令 的 文件 ， 特 定 的 命令 包括 install、update 和 remove。 


当 你 希望 为 那些 使 用 AUTOREV 来 自动 化 从 仓库 分 支 中 获取 最 新 修订 的 包 固 定 源 修 订 时 ， 包 含 在 包 的 latest_srcrev 文 件 中 的 源 修订 信息 是 重要 的 。 你 
可 以 使 用 脚本 buildhistory-collect-srcrevs 来 从 构建 历史 中 以 一 种 可 直接 用 在 例如 conf/local.conf 的 配置 文件 或 者 友 行 版 策略 文件 中 的 格式 收集 源 修 
订 。 针 对 从 版 本 控制 系统 源 中 获得 的 每 个 包 ， 脚 本 产生 以 下 形式 的 一 行 : 


SRCREV_pn-<packagename> = "<versiontag>" 


默认 情况 下 ， 脚 本 仅仅 为 正在 使 用 AUTOREV 的 包产 生 输 出 ， 除 非 在 调用 脚本 的 时 候 ， 你 对 命令 行使 用 -a 或 者 --report-all 参 数 。 


在 配置 中 捐 定 SRCREV_pn-<packagename> 不 会 阻止 变量 被 菜谱 的 退 加 文件 或 者 构建 配置 中 的 其 他 地 广 所 履 善 。 为 了 阻止 覆盖 ， 必 须 增 加 


forcevariable: 
SRCREV_pn-<packagename>_forcevariable = "<versiontag>" 


当 -f 或 者 --forcevariable 被 增加 到 命令 行 时 ， 脚 本 自动 增加 forcevariable。 
构建 历史 软件 开发 工具 包 信 息 


当 软 件 开发 工具 包 (SDK) 目标 被 构建 系统 处 理 时 ， 构 建 历史 收集 关于 SDK 的 内 容 的 信息 。 多 个 SDK 按 照发 行 版 和 镜像 目标 被 分 离 进 子 目 录 中 。 
为 SDK 是 为 构建 主机 和 目标 所 构建 的 ， 所 以 构建 历史 包含 用 于 它们 每 一 个 的 信息 。 用 于 SDK 的 构建 历史 目录 包含 以 下 : 


- files-in-sdk.txt: 包含 在 SDK 中 的 文件 列表 。 这 个 列表 是 针对 构建 主机 和 目标 的 。 
- sdk-info.txt: 决定 SDK 内 容 的 配置 变量 及 其 值 的 列表 ， 以 及 SDK 大 小 的 一 个 条 目 : 


‘DISTRO: 发 行 版 策略 。 


- DISTRO_VERSION: 发 行 版 版 本 字符 串 。 

- SDK_NAME: SDK 名 字 字 符 串 。 

- SDK_VERSION: SDK 的 版 本 字符 串 。 

- SDKMACHINE SDK: 机 器 信息 

- SDKIMAGE_FEATURES: 用 于 构建 SDK 根 文件 系统 镜像 特性 的 列表 ， 这 些 特性 通常 是 dev-pkgs 和 dbg-pkgs。 

- SDKSIZE: SDK 的 大 小 。 

- host 和 target: 包含 具有 关于 主机 和 目标 SDK 的 信息 的 文件 的 目录 。 这 些 文件 在 这 两 个 目录 中 创建 : 

- depends.dot: 以 文本 的 DOT 格 式 表现 的 完整 依赖 性 关系 图 ， 它 可 以 被 Graphviz 和 其 他 能 够 解析 DOT 格 式 的 软件 所 泻 染 。 
- installed-package-names.txt: 以 字母 顺序 排列 的 安装 在 SDK 中 的 包 名 的 列表 。 

- installed-package-sizes.txt: 安装 在 SDK 中 的 包 名 和 包 大 小 的 列表 ， 是 按照 从 最 大 包 到 最 小 包 的 顺序 排列 的 


- installed-packages.txt: 按照 字母 排序 的 、 安 装 在 SDK 中 的 所 有 包 的 完整 包 文 件 名 的 列表 。 


13.3 dR 


在 本 书 4.5 节 中 ， 我 们 讨论 了 构建 系统 如 何 访问 和 下 载 源 ， 以 及 镜像 站 点 可 以 如 何 被 用 来 设置 替代 性 的 下 载 位置 而 不 用 修改 菜谱 中 的 SRC_URI。 
设置 你 自己 的 镜像 站 点 由 于 以 下 原因 来 变 得 很 有 意义 : 

对 有 很 多 开发 者 的 团队 来 说 ， 避 免 从 互联 网 下 载 数 GB 的 源 包 

` 为 了 一 致 性 和 可 重复 性 而 确保 一 个 团队 的 所 有 开发 者 正在 从 相同 的 源 来 构建 。 


-为 产品 交付 控制 源 包 版 本 。 


13.3.1 ”使 用 源 镜像 


我 们 已 经 看 到 ， 在 检查 了 一 个 源 包 是 否 在 由 DL_DIR 指 定 的 本 地 下 载 目 录 中 可 用 之 后 ， 构 建 系 统 首先 使 用 由 变量 PREMIRRORS 指 定 的 镜像 站 点 用 于 对 
源 包 的 远程 访问 。 变 量 包含 由 换行 符 分 隔 的 数组 列表 ， 数 组 为 键 指 定 正 则 表达 式 来 匹配 SRC_URI。 当 然 ， 你 可 以 自己 直接 在 构建 环境 的 conf/local.conf 
文件 中 设置 PREMIRRORS 变 量 。 然 而 ， 更 方便 的 是 ， 你 可 以 使 用 own-mirrors 类 和 变量 SOURCE_MIRROR_URL。 正 如 程序 清单 13-5 所 示 ，own- 
mirrors 类 仪 仪 包含 PREMIRRORS 变 量 赋 值 而 没有 其 他 内 容 。 


程序 清单 13-5 own-mirrors 类 


PREMIRRORS() { 


eves Fras <=" $ {SOURCE _MIRROR_URL} 
A $ {SOURCE MIRROR URL)} 
亲王 S {SOURCE_MIRROR_URL} 
gitsm://.*/.* | ${SOURCE_MIRROR_URL} 
Mees fae S {SOURCE_MIRROR_URL} 
DRE S {SOURCE_MIRROR_URL} 
p4://.*/.* $ {SOURCE_MIRROR_URL} 
3 i a S {SOURCE_MIRROR_URL} 
https?$://.*/.* S{SOURCE_MIRROR_URL} 
TE $ {SOURCE MIRROR URL)} 


} 


类 本 质 上 通过 将 变量 SOURCE_MIRROR_URL 复 制 到 构建 系统 获取 器 所 支持 的 所 有 协议 方案 中 来 为 你 完成 所 有 工作 。 所 有 你 要 做 的 是 ， 继 承 own- 
mirrors 类 并 且 在 构建 环境 的 conf/local.conf 文 件 中 将 SOURCE MIRROR URL 变 量 设置 为 自己 的 镜像 站 点 : 


SOURCE MIRROR URL ?= "file:///path/to/directory/'" 
INHERIT += "own-mirrors" 


例子 使 用 file: 方案 来 直接 访问 文件 系统 ， 它 可 以 是 本 地 或 者 任何 类 型 的 远程 文件 系统 ， 例 如 网 络 文件 系统 (Network File System, NFS) 。 蔡 代 
性 地 ， 你 可 以 为 构建 系统 使 用 ftp: 、http: 和 https: 方 案 来 访问 你 的 镜像 站 点 。 对 团队 开发 来 说 ， 使 用 你 自己 的 友 行 版 策略 而 不 是 本 地 构建 环境 配置 来 设 
置 自己 的 镜像 也 是 有 意义 的 。 


使 用 带 有 SOURCE MIRROR URL 的 own-mirrors 类 或 者 直接 设置 PREMIRRORS 都 不 能 阻止 构建 系统 访问 例如 菜谱 的 SRC_URI 的 其 他 下 载 资源 或 者 
由 MIRRORS 指 定 的 后 镜像 。 然 而 ， 对 于 产品 部 署 ， 关 键 的 是 ， 构 建 系统 不 会 在 无 意 中 从 非 受 控 位 置 获 取 任 何 源 包 。 可 以 通过 设置 MIRRORS 为 空 字符 
来 实现 禁用 后 镜像 。 然 而 ， 在 菜谱 中 全 局 性 地 禁用 SRC_URI 是 不 可 能 的 。 


使 用 


BB_NO_NETWORK = "1" 


禁止 用 于 从 任何 下 载 源 获 取 的 网 络 访问 ,包括 由 PREMIRRORS 指 定 的 那些 。 如 果 你 仅仅 打算 为 镜像 站 点 使 用 file: 方 案 ， 那 么 这 会 工作 得 很 好 。 然 
而 ， 对 一 个 对 团队 开发 有 用 的 、 具 有 自动 化 构建 和 质量 保证 的 设置 来 说， 你 应 该 使 用 FTP、HTTP 或 者 HTTPS 协 议 从 受 控 的 镜像 站 点 来 局 用 获取 而 没有 不 
经 意 地 从 互联 网 上 获取 源 包 的 风险 。 你 可 以 通过 设置 以 下 内 容 而 限制 仅仅 允许 访问 PREMIRRORS 来 实现 这 个 目的 : 


BB_FETCH_PREMIRRORONLY = "1" 


另外 ， 或 者 是 替代 性 地 ， 你 可 以 限制 仅仅 允许 对 特定 主机 的 网 络 访问 。 变 量 BB ALLOWED NETWORKSs 指 定 空格 分 隔 的 主机 列表 ， 构 建 系 统 被 允许 
从 这 些 主机 中 获取 源 包 : 


BB ALLOWED HOSTS = "serverl.acme.com server2.acme.com" 


这 个 例子 允许 从 属于 acme.com 域 的 server1 和 server2 上 获取 。 基 础 的 通配符 匹配 被 提供 来 匹配 主机 名 的 开头 : 例如 


BB ALLOWED HOSTS = "*.acme.com" 


允许 从 任何 属于 acme.com 域 的 主机 上 获取 。 


当 使 用 BB ALLOWED HOSTS 时 ， 列 在 镜像 变量 PREMIRRORS 和 MIRRORS 中 的 主机 被 简单 跳 过 ， 并 且 一 条 日 志 消 息 被 记录 。 用 未 包含 在 
BB_ALLOWED HOSTS 的 主机 来 访问 SRC_URI 会 导致 错误 。 


联合 使 用 BB ALLOWED HOSTS 和 own-mirrors 类 以 及 SOURCE MIRROR _URL 或 者 直接 联合 使 用 BB_ALLOWED HOSTS 和 PREMIRRORS 人 允许 你 利 
用 网 络 协议 方案 同时 阻止 构建 系统 访问 任何 未 被 列 在 BB ALLOWED_ HOSTS 中 的 下 载 站 点 。 增 加 列 在 BB_ALLOWED HOSTS 中 的 主机 到 
SOURCE_MIRROR_URL 或 者 PREMIRRORS 会 导致 源 只 能 从 已 授权 的 主机 获取 。 如 果 源 包 是 在 镜像 站 点 上 缺失 的 ， 那 么 构建 系统 通过 使 用 来 自 菜谱 的 
SRC_URI 来 尝试 获取 它 。 这 会 导致 失败 ， 因 为 在 SRC_URI 中 的 上 游 主 机 没有 被 BB_ALLOWED_HOSTS 列 出 。 这 正 是 你 希望 的 行为 ， 因 为 它 把 任何 从 非 受 
控 的 站 点 访 问 资 源 的 尝试 通知 给 你 。 


13.3.2 ”设置 源 镜 像 
如 何 设置 源 镜像 取决 于 你 。 你 必须 决定 ， 是 否 希 望 在 构建 主机 上 挂 载 来 自 源 镜像 的 文件 系统 导出 并 且 使 用 file: 方 案 ， 或 者 是 否 宁 愿 设置 HTTP/HTTPS 
或 者 FTP 服 务 器 。 在 任何 情况 下 ， 你 必须 使 用 构建 系统 下 载 一 次 源 包 ， 然 后 把 它们 从 由 DL_DIR 指 定 的 下 载 目录 中 复制 到 你 的 镜像 主机 。 


直接 从 远程 源 仓库 (例如 Git、Apache SVN, Perforce) 中 检 出 的 源 以 树 的 形式 被 放 在 下 载 目录 中 。 这 使 得 它们 不 适合 简单 地 复制 到 稍 后 可 以 用 
file:、ftp:、http: 或 者 https: 方 案 访问 的 镜像 站 点 。 在 构建 环境 的 conf/local.conf 中 使 用 


BB GENERATE MIRROR_TARBALLS = "1" 
使 得 构建 系统 从 仓库 树 中 创建 tar 包 ， 然 后 可 以 简单 地 把 它们 以 及 其 他 源 包 复 制 到 你 的 镜像 站 点 。 为 了 性 能 的 原 
因 ，BB_GENERATE_MIRROR TARBALLS 默 认 是 被 禁用 的 。 
以 下 是 几 个 简单 的 步骤 ， 它 们 让 你 设置 自己 的 源 镜像 
1. 设 置 构建 环境 并 且 启 用 BB GENERATE MIRROR TARBALLS。 
2. 用 bitbake-c fetchall<target> 启 动 构建 ， 其 中 <target> 是 任何 综合 性 的 镜像 目标 ， 例 如 core-image-sato。 
3. 复 制 所 有 包含 在 下 载 目录 中 的 源 tar 包 到 你 的 镜像 主机 。 
4. 设 置 一 个 构建 环境 来 继承 own-mirrors 并 且 把 SOURCE_MIRROR_URL 指 向 你 的 新 镜像 。 你 可 以 禁用 BB_ GENERATE_MIRROR TARBALLS。 
5. 局 动 构建 以 测试 从 新 镜像 获取 。 


6. 通 过 按 需 设置 BB_NO_NETWORK 或 者 BB ALLOWED HOSTs 来 调 优 你 的 设置 。 


13.4 ” 目 动 构建 器 


Yocto 项 目 自动 构建 器 (Autobuilder) 是 基于 开源 持续 集成 框架 Buildbot 的 自动 化 构建 系统 [。Buildbot 是 用 于 自动 化 软件 构建 、 质 量 保证 和 发 布 
过 程 的 可 扩展 的 框 染 。 


Buildbot 是 以 Python 编 写 的 ， 并 且 是 使 用 Twisted Python 上 事件 驱动 的 网 络 引擎 来 实现 的 。Buildbot 是 作业 调度 系统 一 一 它 把 作业 排队 ， 监 控 执 
行 作业 的 必要 资源 ， 当 资源 就 位 时 执行 作业 ， 并 且 报 告 结果 。 

Buildbot 部 署 通 常 至 少 由 一 个 控制 器 和 一 组 工作 者 组 成 。 控 制 器 监控 源 代码 仓库 ， 调 度 作业 ， 协 调 工作 者 并 报告 作业 执行 的 结果 。 控 制 器 为 用 户 提 
供 Web 用 户 界面 来 与 系统 交互 。 工 作者 可 以 被 部 署 在 和 控制 器 相同 的 系统 上 ， 或 者 被 部 署 在 独立 的 系统 上 ， 后 者 使 得 Buildbot 成 为 分 布 式 构建 引擎 。 控 
制 器 分 配 构建 器 (builder) 到 工作 者 ， 工 作者 执行 构建 器 并 且 把 结果 报告 回 控制 器 。 

Buildbot 配 置 是 通过 Python 脚本 来 完成 的 ， 这 和 设置 配置 变量 一 样 简单 。 然 而 ， 完 整 的 Python 功能 性 是 可 用 的 ， 这 人 允许 通过 Python 代码 实现 配置 
的 动态 生成 。 

Yocto 项 目 自 动 构建 器 通过 一 组 用 于 Yocto 项 目 目标 的 标准 构建 器 来 扩展 Buildbot。Yocto 项 目 构 建 基础 设施 使 用 自动 构建 器 用 于 每 夜 构 建 、 持 续集 
成 和 发 布 构建 。 你 可 以 通过 其 位 于 https://autobuilderyoctoproject.org 的 首页 来 访问 Yocto 项 目 自动 构建 器 。 除 非 你 有 Yocto 项 目 自动 构建 器 的 登录 账 
号 ， 和 否则 你 不 能 自己 调度 和 执行 构建 ， 但 是 你 可 以 查看 最 新 构建 的 当前 状态 和 构建 历史 。 你 也 可 以 直接 从 Yocto 项 目 自动 构建 器 的 发 布 目录 [下 载 用 于 各 
种 机 器 的 镜像 构建 和 Eclipse 插件 等 。 


Yocto 项 目 构建 团队 已 经 把 目 动 构建 器 以 及 设置 和 执行 脚本 打包 在 一 起 了 ， 这 使 得 让 一 个 自动 构建 器 实例 运行 在 你 自己 的 系统 上 这 一 过 程 变 得 很 短 
(只 需 几 分 钟 ) 。 


[1] http://buildbot.net. 
[2] https: //twistedmattix.com/trac o 


[3] http: //autobuilder.yoctoproject.org/pub. 


13.4.1 “安装 自动 构建 器 


具有 运行 在 相同 主机 上 的 一 个 控制 器 和 一 个 工作 者 的 目 动 构建 器 的 基本 安 妆 和 配置 可 以 通过 以 下 3 个 简单 步骤 来 完成 : 


S git clone git://yoctoproject.org/yocto-autobuilder 
S cd yocto-autobuilder 
S source yocto-autobuilder-setup 


就 这 么 简单 。yocto-autobuilder-setup 脚 本 产生 大 量 输 出 ， 你 应 该 注意 其 中 一 些 : 


- Client-Server Password (客户 端 -服务 器 密码 ) : 这 是 工作 者 用 于 向 控制 器 识别 自己 的 密码 。 这 个 密码 被 用 在 控制 配置 文件 yocto- 
controllet/controllet.cfg 和 工作 者 配置 文件 yocto-worket/buildbot.tac 中 。 


User Name and Password (用 户 名 和 密码 ) : 脚本 为 Web 用 户 界面 创建 用 户 名 和 密码 ， 并 且 把 它们 存储 在 文件 yocto-autobuilder/.htpasswd 中 。 密 
码 是 以 加 密 的 形式 存储 的 ， 所 以 你 需要 记录 下 密码 。 如 果 你 筷 记 或 者 丢失 了 窗 码 ， 那 么 你 可 以 用 以 下 命令 创建 一 个 新 的 并 且 把 它 写 到 密码 文件 中 : 


S cd yocto-autobuilder 
S ./bin/htpasswd -b .htpasswd <username> <password> 


确保 你 使 用 了 自动 构建 器 提供 的 ./bin/htpasswd 命 令 而 不 是 安装 在 你 的 系统 上 的 那个 。 


- Environment Variables (环境 变量 ) : 脚本 增加 自动 构建 器 路 径 到 环境 变量 PYTHONPATH 和 和 PATH， 设置 变 量 YOCTO_AB_CONEIG， 并 且 打 
印 它们 的 值 到 控制 台 。 你 可 以 复制 和 粘贴 设置 到 你 的 .bashtrc 文 件 ， 或 者 你 可 以 在 每 次 希望 使 用 自动 构建 器 的 时 候 引 用 脚本 。 再 次 引用 脚本 是 安全 的 。 它 检 
测 前 面 的 设置 ， 例 如 现存 的 配置 和 密码 文件 ， 并 且 不 会 窗 盖 它们 。 


现在 你 可 以 用 以 下 命令 启动 自动 构建 器 : 
S ./auto-start-autobuilder both 


它 在 相同 的 节点 上 局 动 了 一 个 控制 器 和 一 个 工作 者 。 脚 本 接受 以 下 参数 : 

‘both (两 者 ) : 启动 控制 器 和 工作 者 。 

- controller (控制 器 ) : 仅仅 启动 控制 器 。 

- worker (工作 者 ) : 仅仅 启动 工作 者 。 

为 了 关闭 自动 构建 器 ， 使 用 yocto-stop-autobuilder， 它 和 启动 脚本 接受 相同 的 参数 。 


在 局 动 了 目 动 构建 器 后 ， 把 你 的 浏览 器 指向 : 


localhost:8010 


它 把 你 审 到 自动 构建 器 登录 页 面 。 从 那里 开始 ， 你 可 以 使 用 你 的 用 户 名 和 密码 登录 目 动 构 建 器 。 


单 击 Builders 链 接 ， 它 把 你 带 到 所 有 已 配置 的 构建 器 列表 。 单 击 一 个 ， 例 如 nightly-x86-64。 为 了 在 其 周期 调度 之 外 强制 启动 一 个 构建 器 ， 单 击 
Force Build 按 钮 。 一 旦 构建 器 被 启动 ， 你 可 以 在 Waterfall 视 图 中 观察 它 的 进度 。 


13.4.2 配置 目 动 构 建 器 


自动 构建 器 配置 是 通过 一 系列 配置 文件 来 完成 的 。 这 些 不 是 BitBake 配 置 文件 。 那 意味 着 ， 没 有 BitBake 变 量 扩展 可 供 你 使 用 。 
目 动 构建 器 全 局 配置 文件 


文件 config/autobuilder.conf 是 全 局 的 自动 构建 器 配置 文件 。 文 件 被 划分 为 几 个 部 分 。 每 个 部 分 是 通过 中 括号 内 的 部 分 名 来 引入 的 。 每 个 部 分 包含 
一 个 或 者 多 个 配置 变量 。 部 分 名 和 变量 名 大 部 分 是 不 用 解释 的 。 这 里 ， 我 们 讨论 你 最 党 希望 调整 的 参数 。 


- [GitSettings]: 处 理 Git 仓 库 。 


.OPTIMIZED_GIT_CLONE : 如 果 设 置 为 Ttue， 那 么 Git 仓 库 在 使 用 后 被 移动 到 临时 存储 位 置 而 不 是 从 自动 构建 器 中 删除 。 这 加 速 了 构建 过 程 ， 但 
是 需要 用 定时 任务 来 执行 对 过 时 目录 的 外 部 清理 。 上 默认 设置 是 True。 然 而 ， 这 个 设置 是 相当 耗费 磁盘 空间 的 。 如 果 你 的 工作 者 磁盘 空间 不 多 ， 那 么 你 可 
能 希望 考虑 禁用 这 个 设置 。 


- OGIT_TRASH_DIR: 过 时 的 Git 仓 库 被 移动 到 的 目录 。 

- OGIT_MIRROR_DIR: 克隆 Git 仓 库 所 到 的 目录 。 

- OGIT_TRASH_CRON_TIME: 用 于 清理 过 时 Git 仓 库 的 定时 任务 设置 。 

- OGIT_TRASH_NICE_LEVEL: 清理 任务 的 优先 级 。 

- [BuildHistorySettings]: 自动 构建 器 是 否 收集 构建 历史 以 及 在 哪里 存储 它 。 

- BUILD_HISTORY_COLLECT: 如 果 设 置 为 True， 那 么 自动 构建 器 收集 构建 历史 。 
- BUILD_HISTORY_DIR: 构建 历史 被 存储 在 的 目录 。 

- BUILD_HISTORY_REPO: 用 于 构建 历史 的 远程 仓库 。 

- [ErrorReportSettings]: 自动 构建 器 是 否 收集 、 存 储 和 发 布 有 关 自 动 构建 器 遇 到 的 错误 的 报告 
- ERROR_REPORT_COLLECT: 如 果 设 置 为 True， 自 动 构 建 器 收集 错误 报告 

- ERROR_REPORT_EMAIL: 错误 报告 被 发 送 到 的 邮箱 地 址 。 

- [PublishSettings]: 是 否 以 及 向 哪里 发 布 构建 制品 。 


- PUBLISH_BUILDS: 如 果 设 置 成 Ttue， 那 么 自动 构建 器 发 布 镜像 和 包 人 仓库 到 MACHINE_PUBLISH_DIR、QEMU_PUBLISH_DIR、 


RPM _PUBLISH _DIR、DEB_PUBLISH _DIR 和 IPK_PUBLISH _DIR， 它 们 是 BUILD_PUBLISH_DIR 的 子 目 录 。 
- PUBLISH_SOURCE_MIRROR: 如 果 设 置 为 True， 自 动 构建 器 发 布 要 用 于 一 个 源 镜像 的 源 文 件 到 SOURCE_PUBLISH_DIR。 
- PUBLISH_SSTATE: 如 果 设 置 成 True， 自 动 构建 器 发 布 共享 状态 环境 到 SSTATE_PUBLISH_DIR。 
- [BuildSettings]: 用 于 被 工作 者 使 用 的 构建 环境 的 conf/local.conf 文 件 的 设置 。 
` [QAEmail]: 自动 构建 器 应 该 发 送 关于 构建 结果 的 邮件 所 到 的 邮箱 地 址 。 


通常 ， 你 可 能 和 希望 调整 用 于 构建 制品 的 目录 而 希望 其 他 你 需要 的 数据 保留 。 默 认 设置 把 折 有 文件 仓储 在 /tmp/yocto-autobuilder， 当 系统 重 局 时 ， 
这 个 目录 会 丢失 。 


控制 器 配置 文件 


文件 yocto-controller/controller.cfg 包 含 用 于 控制 器 的 配置 设置 。 这 个 文件 使 用 Python 语 法 。 所 有 配置 被 存储 在 一 个 名 为 BuildmasterConfig 的 字 
典 中 。 这 些 是 由 位 于 http://docs.buildbot.net 的 Buildbot 文 档 详细 解释 的 Buildbot 配 置 设置 。 我 们 在 此 履 善 一些 最 重要 的 内 容 : 


- c[debugPassword']: 如 果 设 置 了 ， 那 么 你 可 以 使 用 Buildbot 调 试 客户 端 来 连接 控制 器 。 
: C[title']: 显示 在 自动 构建 器 网 页 上 部 的 标题 。 

- C['titleURL']: 谱 入 在 标题 中 的 URL (通常 匹配 crbuildbotURI]) 。 

-c['buildbotURL']: 自动 构建 器 的 Web 服 务 器 监听 到 的 URL、 主 机 和 端口 。 


-c{'workers']: 被 控制 器 识别 的 工作 者 列表 。 每 个 工作 者 必须 有 一 个 唯一 的 名 字 和 其 用 于 向 控制 器 进行 身份 验证 的 密码 。 工 作者 名 字 和 密码 必须 匹 
配 工 作者 配置 中 的 对 应 值 。 


- c{['workerPortnum']: 控制 器 监听 用 于 接受 工作 者 连接 的 TCP 端 口号 。 端 口号 必须 匹配 工作 者 配置 的 端口 号 码 。 


- c['status]: 自动 构建 器 向 其 发 布 构建 状态 报告 的 状态 目标 列表 。Buildbot 提 供 大 量 状态 目标 ， 例 如 网 页 、 邮 件 发 送 程序 和 互联 网 中 继 聊 天 
(Internet Relay Chat, IRC) 机 器 人 。Buildbot 文 档 包 含 关于 如 何 配 置 各 种 状态 目标 的 细节 。 


. C['db']: 自动 构建 器 用 于 存储 它 状态 信息 的 数据 库 。 默 认 是 SQLite 数 据 库 。 其 他 数据 库 (包括 MySQL 和 PostgreSQL) 是 可 以 配置 的 。Buildbot 文 档 
解释 了 细节 。 为 了 性 能 原因 ， 你 可 能 希望 为 生产 环境 使 用 RDBMS 而 不 是 SQLite。 


你 可 在 文件 中 设置 其 他 配置 选项 ， 例 如 c['multiMaster']， 它 允许 使 用 多 个 控制 器 来 创建 更 加 可 伸缩 的 构建 工厂 。 
工作 者 配置 文件 
文件 yocto-worker/buildbot.tac 包 含 工 作者 信息 。 这 个 文件 也 使 用 Python 语 法 。 这 些 是 你 需要 调整 以 创建 分 布 式 系统 的 设置 : 
- buildmaster host: 控制 器 正在 运行 的 主机 名 或 者 主机 的 IP 地 址 。 
port: 控制 器 监听 用 以 接收 工作 者 连接 的 端口 号 。 值 必须 匹配 控制 器 配置 的 c[workerPortnum']。 
-workername: 用 于 工作 者 的 唯一 性 名 字 。 值 必须 匹配 在 控制 器 配置 的 c[wotkets] 中 的 工作 者 的 名 字 。 


. passwd: 用 于 和 控制 器 进行 身份 验证 的 密码 。 值 必须 匹配 用 于 在 控制 器 配置 的 c[wotketrs] 中 的 工作 者 的 密码 。 


构建 集 配置 


自动 构建 器 根 目录 包含 多 个 其 名 字 全 部 以 buildset- 开 头 的 目录 。 在 Buildbot 语 言 中 ， 构 建 集 是 一 系列 按照 构建 集 定 义 的 顺序 执行 的 步骤 。 程 序 清 
13-6 显 示 了 用 于 每 夜 x86_64 构 建 的 目 动 构建 器 构建 集 。 


程序 清单 13-6 nightly-x86-64 构 建 集 (buildset-config/nightly-x86-64.conf) 


[nightly-x86-64] 
builders: 'example-worker' 
repos: [{'poky': 
{'repourl': 'git://git.yoctoproject.org/poky', 
'layerversion': {'core':'meta', 'yoctobsp':'meta-yocto-bsp'}, 
'branch': 'master' }}] 
steps: [{'SetDest': {}}, 
{'CheckOutLayers': {}}, 
{'RunPreamble': {}}, 
{'GetDistroVersion': {'distro': 'poky'}}, 
{'CreateAutoConf': {'machine': 'qemux86-64', 'SDKMACHINE': '1686', 
‘drstro’« OGA ‘burldhistery’ e Truett, 
{'CreateBBLayersConf': {'buildprovider': ‘'yocto'}}, 
{"SynePersistDB*: {"*distro’s "poky’}}, 
{'GetBitbakeVersion': {}}, 
{'BuildImages': {'images': 'core-image-sato core-image-sato-dev 
core-image-sato-sdk core-image-minimal 
core-image-minimal-dev'}}, 


{'RunSanityTests': {'images': 'core-image-minimal core-image-sato 
core-image-sato-sdk'}}, 
{'CreateAutoConf': {'machine': 'genericx86-64', 


'SDKMACHINE': '1686', 

'buildhistory': False, 'distro': 'poky'}}, 
{'BuildImages': {'images': 'core-image-sato core-image-sato-dev 

core-image-sato-sdk core-image-minimal 
core-image-minimal-dev'}}, 

{'CreateAutoConf': {'machine': 'qemux86-64', 

'SDKMACHINE': '1686', 

'distro': poky’; ‘buildhistory': False}}, 
{'BuildToolchainImages': {}}, 
{'RunSDKSanityTests': {'images': 'core-image-sato'}}, 
{'CreateAutoConf': {'machine': 'qemux86-64', 

'SDKMACHINE': 'x86_64', 

‘distro’: “poky’, "“burldhastory': False}}., 
{'BuildToolchainImages': {}}, 
{'RunSDKSanityTests': {'images': 'core-image-sato'}}, 
{'SyncPersistDB': {'commit': True, 'distro': 'poky'}}, 
{'PublishLayerTarballs': {}}, 
{'SendErrorReport': {}}, 
{'UploadToasterEventlog': {}}, 
{'PublishArtifacts': {'artifacts': ['qemux86-64', 'genericx86-64', 

'ipk';y "“toolchain', 'mdSsume* ]}}] 


构建 集 通 常 至 少 包 含 这 些 元 素 : 
- Buildset Name (构建 集 名 字 ) : 在 中 括号 (M 内 的 构建 集 的 名 字 。 
-Repos (仓库 ) : 包含 要 监控 的 仓库 描述 的 字典 列表 。 仓 库 描述 本 身 就 是 一 个 字典 ， 它 的 键 是 repourl、layerversion 和 branch。 


- Steps (R) : 构建 步骤 字典 列表 。 构 建 步骤 是 位 于 自动 构建 器 根 目 389 lib/python2.7 /site-packages /autobuilder/buildsteps P #9Python#. HIRT 
能 接受 参数 ， 它 们 是 作为 字典 来 提供 的 。 


Buildbot 包 含 关 于 如 何 创建 构建 集 和 构建 步 又 的 通用 例子 和 解释 。 文 件 EADME-NEW-AUTOBUILDER 解 释 自 动 构 建 器 构建 集合 构建 步 又 是 如 何 被 
配置 的 。 
13.5 ”总结 


在 本 章 中 ， 我 们 摘 述 了 你 可 以 用 来 伸缩 Yocto 项 目 构 建 系统 到 开 友 团队 和 生产 环境 的 工具 和 技术 。 


- Toastet 用 Web 用 户 界 面 来 扩展 了 构建 系统 ， 它 允许 远程 部 署 和 共享 的 构建 资源 。 


+ 构建 历史 提供 对 构建 配置 和 构建 输出 的 追踪 。 它 是 维护 构建 质量 和 可 重复 性 的 重要 工具 。 由 一 个 初始 构建 创建 的 基线 (baseline) 开始 ， 对 配置 和 
元 数据 制品 的 变更 被 保存 在 Git 仓 库 中 以 创建 因果 关系 的 无 缝 历史 。 


` 通过 使 用 源 镜 像 ， 开 发 团队 可 以 共享 源 下 载 ， 并 且 生 产 环 境 可 以 控制 用 于 生产 部 署 的 软件 包 镜 像 是 从 什么 源 镜像 中 创建 的 。 


-自动 构建 器 为 Yocto 项 目 构建 提供 自动 化 的 持续 构建 和 集成 系统 。 它 是 一 个 完全 开 箱 即 用 (out-of-the-box) 的 解决 方案 ， 它 已 经 准备 好 在 短 时 间 内 
被 部 署 。 它 的 默认 构建 集 和 覆盖 所 有 标准 Yocto 项 目 构建 目标 。 它 们 是 一 个 坚实 的 基础 ， 可 被 轻松 扩展 和 调整 到 适合 你 自己 的 需求 。 


13.6 参考 文献 


Buildbot37#4, http://docs.buildbot.net, 
Yocto 项 目 自 动 构建 器 ，https://www.yoctoproject.org/tools-resources/projects/autobuilder。 
Yocto 项 目 参 考 手册 ,www.yoctoproject.org/docs/2.0/ref-manual/ref-manual.html。 
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附录 A ”开源 许可 协议 


开源 许可 的 列表 是 相当 长 的 。OpenEmbedded 构 建 系统 在 它 的 meta/files/common-licenses 目 录 中 提供 用 到 的 173 种 许可 的 文本 。 开 源 组 织 


(Open Source Initiative, OSI) 【分 析 和 审查 许可 并 且 发 布 已 批准 的 开源 许可 列表 ， 这 样 做 的 目的 是 ， 向 用 户 、 开 发 者 、 商 业 和 政府 机 构 提供 对 开源 
许可 的 教育 。 作 为 参考 ， 最 常用 的 4 个 开源 许可 的 逐 字 文本 在 本 附录 中 提供 。 


A.1 MIT License (MIT) 


The MIT License (MIT) 

Copyright (c) <year> <copyright holders> 

Permission is hereby granted, free of charge, to any person obtaining a copy of this 
software and associated documentation files (the “Software’’), to deal in the Software 
without restriction, including without limitation the rights to use, copy, modify, merge, 
publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons 
to whom the Software is furnished to do so, subject to the following conditions: 

The above copyright notice and this permission notice shall be included in all copies 
or substantial portions of the Software. 

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY 
KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE 
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR 
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS 
OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR 


OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 


A.2 GNU General Public License (GPL) Version 2 


GNU GENERAL PUBLIC LICENSE 

Version 2, June 1991 

Copyright (C) 1989, 1991 Free Software Foundation, Inc. 

51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 

Everyone is permitted to copy and distribute verbatim copies of this license document, 
but changing it is not allowed. 


Preamble 


The licenses for most software are designed to take away your freedom to share and 
change it. By contrast, the GNU General Public License is intended to guarantee your 
freedom to share and change free software—to make sure the software 1s free for all its 
users. This General Public License applies to most of the Free Software Foundation’s 
software and to any other program whose authors commit to using it. (Some other Free 
Software Foundation software is covered by the GNU Library General Public License 
instead.) You can apply it to your programs, too. 

When we speak of free software, we are referring to freedom, not price. Our Gen- 
eral Public Licenses are designed to make sure that you have the freedom to distribute 
copies of free software (and charge for this service if you wish), that you receive source 
code or can get it if you want it, that you can change the software or use pieces of it in 
new free programs; and that you know you can do these things. 

To protect your rights, we need to make restrictions that forbid anyone to deny you 
these rights or to ask you to surrender the rights. These restrictions translate to certain 
responsibilities for you if you distribute copies of the software, or if you modify it. 

For example, if you distribute copies of such a program, whether gratis or for a fee, 
you must give the recipients all the rights that you have. You must make sure that they, 
too, receive or can get the source code. And you must show them these terms so they 
know their rights. 

We protect your rights with two steps: (1) copyright the software, and (2) offer you 
this license which gives you legal permission to copy, distribute and/or modify the 
software. 

Also, for each author’s protection and ours, we want to make certain that everyone 
understands that there is no warranty for this free software. If the software 1s modified 
by someone else and passed on, we want its recipients to know that what they have is 
not the original, so that any problems introduced by others will not reflect on the orig- 
inal authors’ reputations. 

Finally, any free program ls threatened constantly by software patents. We wish to 
avoid the danger that redistributors of a free program will individually obtain patent 
licenses, in effect making the program proprietary. To prevent this, we have made it 


clear that any patent must be licensed for everyone’s free use or not licensed at all. 
The precise terms and conditions for copying, distribution and modification follow. 


Terms and Conditions for Copying, Distribution and Modification 


0. This License applies to any program or other work which contains a notice 
placed by the copyright holder saying it may be distributed under the terms of 
this General Public License. The “Program”, below, refers to any such program 
or work, and a “work based on the Program” means either the Program or any 
derivative work under copyright law: that is to say, a work containing the Pro- 
gram or portion of it, either verbatim or with modifications and/or translated 
into another language. (Hereinafter, translation is included without limitation in 
the term “modification’.) Each licensee is addressed as “you”. 


Activities other than copying, distribution and modification are not covered 

by this License; they are outside its scope. The act of running the Program is 
not restricted, and the output from the Program 1s covered only if its contents 
constitute a work based on the Program (independent of having been made by 
running the Program). Whether that is true depends on what the Program does. 


1. You may copy and distribute verbatim copies of the Program’s source code as 
you receive it, in any medium, provided that you conspicuously and appropri- 
ately publish on each copy an appropriate copyright notice and disclaimer of 
warranty; keep intact all the notices that refer to this License and to the absence 
of any warranty; and give any other recipients of the Program a copy of this 
License along with the Program. 


You may charge a fee for the physical act of transferring a copy, and you may at 
your option offer warranty protection in exchange for a fee. 


2. You may modify your copy or copies of the Program or any portion of it, thus 
forming a work based on the Program, and copy and distribute such modifica- 
tions or work under the terms of Section 1 above, provided that you also meet 
all of these conditions: 


a. You must cause the modified files to carry prominent notices stating that you 
changed the files and the date of any change. 


b. You must cause any work that you distribute or publish, that in whole or in part 
contains or 1s derived from the Program or any part thereof, to be licensed as a 
whole at no charge to all third parties under the terms of this License. 


c. If the modified program normally reads commands interactively when run, 
you must cause it, when started running for such interactive use in the most 
ordinary way, to print or display an announcement including an appropriate 
copyright notice and a notice that there is no warranty (or else, saying that 
you provide a warranty) and that users may redistribute the program under 
these conditions, and telling the user how to view a copy of this License. 
(Exception: if the Program itself is interactive but does not normally print 
such an announcement, your work based on the Program 1s not required to 
print an announcement.) 


These requirements apply to the modified work as a whole. If identifiable 
sections of that work are not derived from the Program, and can be reasonably 
considered independent and separate works in themselves, then this License, and 
its terms, do not apply to those sections when you distribute them as separate 
works. But when you distribute the same sections as part of a whole which is a 
work based on the Program, the distribution of the whole must be on the terms 
of this License, whose permissions for other licensees extend to the entire whole, 
and thus to each and every part regardless of who wrote it. 


Thus, it is not the intent of this section to claim rights or contest your rights to 
work written entirely by you; rather, the intent is to exercise the right to control 
the distribution of derivative or collective works based on the Program. 


In addition, mere aggregation of another work not based on the Program with 
the Program (or with a work based on the Program) on a volume of a storage 
or distribution medium does not bring the other work under the scope of this 
License. 


. You may copy and distribute the Program (or a work based on it, under Section 2) 
in object code or executable form under the terms of Sections 1 and 2 above 
provided that you also do one of the following: 


a. Accompany it with the complete corresponding machine-readable source 
code, which must be distributed under the terms of Sections 1 and 2 above on 
a medium customarily used for software interchange; or, 


b. Accompany it with a written offer, valid for at least three years, to give any 
third party, for a charge no more than your cost of physically performing 
source distribution, a complete machine-readable copy of the corresponding 
source code, to be distributed under the terms of Sections 1 and 2 above on a 
medium customarily used for software interchange; or, 


c. Accompany it with the information you received as to the offer to distribute 
corresponding source code. (This alternative is allowed only for noncom- 
mercial distribution and only if you received the program in object code or 
executable form with such an offer, in accord with Subsection b above.) 


The source code for a work means the preferred form of the work for making 
modifications to it. For an executable work, complete source code means all the 
source code for all modules it contains, plus any associated interface definition 
files, plus the scripts used to control compilation and installation of the exe- 
cutable. However, as a special exception, the source code distributed need not 
include anything that 1s normally distributed (in either source or binary form) 
with the major components (compiler, kernel, and so on) of the operating system 
on which the executable runs, unless that component itself accompanies the 
executable. 

If distribution of executable or object code is made by offering access to copy 
from a designated place, then offering equivalent access to copy the source code 
from the same place counts as distribution of the source code, even though third 
parties are not compelled to copy the source along with the object code. 


4. You may not copy, modify, sublicense, or distribute the Program except as 
expressly provided under this License. Any attempt otherwise to copy, modify, 
sublicense or distribute the Program is void, and will automatically terminate 
your rights under this License. However, parties who have received copies, or 
rights, from you under this License will not have their licenses terminated so 
long as such parties remain in full compliance. 


5. You are not required to accept this License, since you have not signed it. How- 
ever, nothing else grants you permission to modify or distribute the Program 
or its derivative works. These actions are prohibited by law if you do not accept 
this License. Therefore, by modifying or distributing the Program (or any work 
based on the Program), you indicate your acceptance of this License to do so, 
and all its terms and conditions for copying, distributing or modifying the Pro- 
gram or works based on it. 


6. Each time you redistribute the Program (or any work based on the Program), 
the recipient automatically receives a license from the original licensor to copy, 
distribute or modify the Program subject to these terms and conditions. You 
may not impose any further restrictions on the recipients’ exercise of the rights 
granted herein. You are not responsible for enforcing compliance by third parties 
to this License. 


7. If, as a consequence of a court judgment or allegation of patent infringement or 
for any other reason (not limited to patent issues), conditions are imposed on you 
(whether by court order, agreement or otherwise) that contradict the conditions 
of this License, they do not excuse you from the conditions of this License. If 
you cannot distribute so as to satisfy simultaneously your obligations under this 
License and any other pertinent obligations, then as a consequence you may not 
distribute the Program at all. For example, if a patent license would not per- 
mit royalty-free redistribution of the Program by all those who receive copies 
directly or indirectly through you, then the only way you could satisfy both it 
and this License would be to refrain entirely from distribution of the Program. 


If any portion of this section is held invalid or unenforceable under any particu- 
lar circumstance, the balance of the section is intended to apply and the section 
as a whole is intended to apply in other circumstances. 


It is not the purpose of this section to induce you to infringe any patents or other 
property right claims or to contest validity of any such claims; this section has 
the sole purpose of protecting the integrity of the free software distribution sys- 
tem, which is implemented by public license practices. Many people have made 
generous contributions to the wide range of software distributed through that 
system ln reliance on consistent application of that system; it is up to the author/ 
donor to decide if he or she ls willing to distribute software through any other 
system and a licensee cannot impose that choice. 


This section is intended to make thoroughly clear what is believed to be a conse- 
quence of the rest of this License. 


8. If the distribution and/or use of the Program is restricted in certain countries 


either hv natents or hv convrichted interfaces. the original convright holder who 


10. 


places the Program under this License may add an explicit geographical distribu- 
tion limitation excluding those countries, so that distribution 1s permitted only 
in or among countries not thus excluded. In such case, this License incorporates 
the limitation as if written in the body of this License. 


. The Free Software Foundation may publish revised and/or new versions of the 


General Public License from time to time. Such new versions will be similar in 
spirit to the present version, but may differ in detail to address new problems or 
concerns. 


Each version is given a distinguishing version number. If the Program specifies 
a version number of this License which applies to it and “any later version,” you 
have the option of following the terms and conditions either of that version or 
of any later version published by the Free Software Foundation. If the Program 
does not specify a version number of this License, you may choose any version 
ever published by the Free Software Foundation. 


If you wish to incorporate parts of the Program into other free programs whose 
distribution conditions are different, write to the author to ask for permission. 
For software which is copyrighted by the Free Software Foundation, write to 
the Free Software Foundation; we sometimes make exceptions for this. Our 
decision will be guided by the two goals of preserving the free status of all 
derivatives of our free software and of promoting the sharing and reuse of soft- 
ware generally. 


No Warranty 


11. 


PA 


BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE; LHERE I 
NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMIT- 
TED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN 
WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES 
PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY 
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY 
AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK 
AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM 

IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU 
ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR 
CORRECTION, 


IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR 
AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR 
ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIB- 
UTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU 
FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDEN- 
TAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE 
OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT 
LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INAC- 
CURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR 


A PALURE OP TEE. PROGRAM TO OPERATE WITH ANY OTHER 
PROGRAMS), EVEN IF SUCH HOLDER OR. OTHER PARTY HAS 
BEEN ADVISED OP THE POSSIBILITY OF SUCH DAMAGES. 


END OF TERMS AND CONDITIONS 


How to Apply These Terms to Your New Programs 


If you develop a new program, and you want it to be of the greatest possible use to 
the public, the best way to achieve this ls to make it free software which everyone can 
redistribute and change under these terms. 

To do so, attach the following notices to the program. It is safest to attach them to 
the start of each source file to most effectively convey the exclusion of warranty; and 
each file should have at least the “copyright” line and a pointer to where the full notice 
is found. 


One line to give the program’s name and a brief idea of what it does. 
Copyright (C) <year> <name of author> 


This program is free software; you can redistribute it and/or modify it under 
the terms of the GNU General Public License as published by the Free Software 
Foundation; either version 2 of the License, or (at your option) any later version. 


This program is distributed in the hope that it will be useful, but WITHOUT 
ANY WARRANTY; without even the implied warranty of MERCHANT- 
ABILITY or FITNESS FORA PAR TICULAR, PURPOSE, See the GNU 


General Public License for more details. 


You should have received a copy of the GNU General Public License along 
with this program; if not, write to the Free Software Foundation, Inc., 59 


Temple Place, Suite 330, Boston, MA 02111-1307 USA 


Also add information on how to contact you by electronic and paper mail. 
If the program is interactive, make it output a short notice like this when it starts in 
an interactive mode: 


Gnomovision version 69, Copyright (C) year name of author Gnomovision 
comes with ABSOLUTELY NO WARRANTY; for details type ‘show w'. 
This 1s free software, and you are welcome to redistribute it under certain 
conditions; type ‘show c' for details. 


The hypothetical commands ‘show w' and ‘show c' should show the appropriate 
parts of the General Public License. Of course, the commands you use may be called 
something other than ‘show w' and ‘show c'; they could even be mouse-clicks or menu 
items—whatever suits your program. 

You should also get your employer (if you work as a programmer) or your school, 
if any, to sign a “copyright disclaimer” for the program, if necessary. Here is a sample; 
alter the names: 


Yoyodyne, Inc., hereby disclaims all copyright interest in the program 
‘Gnomovision' (which makes passes at compilers) written by James Hacker. 


signature of Ty Coon, 1 April 1989 
Ty Coon, President of Vice 


This General Public License does not permit incorporating your program into 
proprietary programs. If your program ls a subroutine library, you may consider it more 
useful to permit linking proprietary applications with the library. If this is what you 
want to do, use the GNU Library General Public License instead of this License. 


A.3 GNU General Public License (GPL) Version 3 


GNU GENERAL PUBLIC. LICENSE 

Version 3, 29 June 2007 

Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> 

Everyone is permitted to copy and distribute verbatim copies of this license document, 
but changing it is not allowed. 


Preamble 


The GNU General Public License is a free, copyleft license for software and other 
kinds of works. 

The licenses for most software and other practical works are designed to take away 
your freedom to share and change the works. By contrast, the GNU General Public 
License is intended to guarantee your freedom to share and change all versions of a 
program—to make sure it remains free software for all its users. We, the Free Software 
Foundation, use the GNU General Public License for most of our software; it applies 
also to any other work released this way by its authors. You can apply it to your pro- 
grams, too. 


When we speak of free software, we are referring to freedom, not price. Our Gen- 
eral Public Licenses are designed to make sure that you have the freedom to distribute 
copies of free software (and charge for them if you wish), that you receive source code 
or can get it if you want it, that you can change the software or use pieces of it in new 
free programs, and that you know you can do these things. 

To protect your rights, we need to prevent others from denying you these rights 
or asking you to surrender the rights. Therefore, you have certain responsibilities if 
you distribute copies of the software, or if you modify it: responsibilities to respect the 
freedom of others. 

For example, if you distribute copies of such a program, whether gratis or for a fee, 
you must pass on to the recipients the same freedoms that you received. You must make 
sure that they, too, receive or can get the source code. And you must show them these 
terms so they know their rights. 

Developers that use the GNU GPL protect your rights with two steps: (1) assert 
copyright on the software, and (2) offer you this License giving you legal permission to 
copy, distribute and/or modify it. 

For the developers’ and authors’ protection, the GPL clearly explains that there is no 
warranty for this free software. For both users’ and authors’ sake, the GPL requires that 
modified versions be marked as changed, so that their problems will not be attributed 


erroneously to authors of previous versions. 

Some devices are designed to deny users access to install or run modified versions of 
the software inside them, although the manufacturer can do so. This is fundamentally 
incompatible with the aim of protecting users’ freedom to change the software. The 
systematic pattern of such abuse occurs in the area of products for individuals to use, 
which is precisely where it is most unacceptable. Therefore, we have designed this version 
of the GPL to prohibit the practice for those products. If such problems arise substan- 
tially in other domains, we stand ready to extend this provision to those domains in 
future versions of the GPL, as needed to protect the freedom of users. 

Finally, every program is threatened constantly by software patents. States should 
not allow patents to restrict development and use of software on general-purpose com- 
puters, but in those that do, we wish to avoid the special danger that patents applied to 
a free program could make it effectively proprietary. To prevent this, the GPL assures 
that patents cannot be used to render the program non-free. 

The precise terms and conditions for copying, distribution and modification follow. 


Terms and Conditions 


0. Definitions. 
“This License” refers to version 3 of the GNU General Public License. 


“Copyright” also means copyright-like laws that apply to other kinds of works, 
such as semiconductor masks. 
“The Program” refers to any copyrightable work licensed under this License. 
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Each licensee is addressed as “you”. “Licensees” and “recipients” may be individ- 


uals or organizations. 


To “modify” a work means to copy from or adapt all or part of the work in a 
fashion requiring copyright permission, other than the making of an exact copy. 
The resulting work is called a “modified version” of the earlier work or a work 
“based on” the earlier work. 


A “covered work” means either the unmodified Program or a work based on the 
Program. 


To “propagate” a work means to do anything with it that, without permission, 
would make you directly or secondarily liable for infringement under applicable 
copyright law, except executing it on a computer or modifying a private copy. 
Propagation includes copying, distribution (with or without modification), 
making available to the public, and in some countries other activities as well. 


To “convey” a work means any kind of propagation that enables other parties to 
make or receive copies. Mere interaction with a user through a computer net- 
work, with no transfer of a copy, is not conveying. 


An interactive user interface displays “Appropriate Legal Notices” to the extent 
that it includes a convenient and prominently visible feature that (1) displays an 
appropriate copyright notice, and (2) tells the user that there 1s no warranty for 
the work (except to the extent that warranties are provided), that licensees may 
convey the work under this License, and how to view a copy of this License. 


If the interface presents a list of user commands or options, such as a menu, a 


prominent item ln the list meets this criterion. 
. Source Code. 


The “source code” for a work means the preferred form of the work for making 
modifications to it. “Object code” means any non-source form of a work. 


A “Standard Interface” means an interface that either 1s an official standard 
defined by a recognized standards body, or, 1n the case of interfaces specified for 
a particular programming language, one that is widely used among developers 
working in that language. 


The “System Libraries” of an executable work include anything, other than the 
work as a whole, that (a) is included in the normal form of packaging a Major 
Component, but which is not part of that Major Component, and (b) serves only 
to enable use of the work with that Major Component, or to implement a Stan- 
dard Interface for which an implementation is available to the public in source 
code form. A “Major Component’, in this context, means a major essential 
component (kernel, window system, and so on) of the specific operating system 
(if any) on which the executable work runs, or a compiler used to produce the 
work, or an object code interpreter used to run it. 

The “Corresponding Source” for a work in object code form means all the source 
code needed to generate, install, and (for an executable work) run the object 
code and to modify the work, including scripts to control those activities. How- 
ever, 1t does not include the work’s System Libraries, or general-purpose tools 

or generally available free programs which are used unmodified in performing 
those activities but which are not part of the work. For example, Corresponding 
Source includes interface definition files associated with source files for the work, 
and the source code for shared libraries and dynamically linked subprograms that 
the work is specifically designed to require, such as by intimate data commu- 
nication or control flow between those subprograms and other parts of the work. 


The Corresponding Source need not include anything that users can regenerate 
automatically from other parts of the Corresponding Source. 


The Corresponding Source for a work in source code form is that same work. 
. Basic Permissions. 


All rights granted under this License are granted for the term of copyright on the 
Program, and are irrevocable provided the stated conditions are met. This License 
explicitly affirms your unlimited permission to run the unmodified Program. The 
output from running a covered work is covered by this License only if the output, 
given its content, constitutes a covered work. This License acknowledges your 
rights of fair use or other equivalent, as provided by copyright law. 


You may make, run and propagate covered works that you do not convey, 
without conditions so long as your license otherwise remains in force. You may 
convey covered works to others for the sole purpose of having them make mod- 
ifications exclusively for you, or provide you with facilities for running those 
works, provided that you comply with the terms of this License in conveying all 


material for which you do not control copyright. Those thus making or running 
the covered works for you must do so exclusively on your behalf, under your 
direction and control, on terms that prohibit them from making any copies of 
your copyrighted material outside their relationship with you. 


Conveying under any other circumstances is permitted solely under the condi- 
tions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 


. Protecting Users’ Legal Rights From Anti-Circumvention Law. 


No covered work shall be deemed part of an effective technological measure 
under any applicable law fulfilling obligations under article 11 of the WIPO 
copyright treaty adopted on 20 December 1996, or similar laws prohibiting or 
restricting circumvention of such measures. 


When you convey a covered work, you waive any legal power to forbid circum- 
vention of technological measures to the extent such circumvention 1s effected 
by exercising rights under this License with respect to the covered work, and 
you disclaim any intention to limit operation or modification of the work as a 
means of enforcing, against the work’s users, your or third parties’ legal rights to 
forbid circumvention of technological measures. 


. Conveying Verbatim Copies. 


You may convey verbatim copies of the Program’s source code as you receive it, 
in any medium, provided that you conspicuously and appropriately publish on 
each copy an appropriate copyright notice; keep intact all notices stating that 
this License and any non-permissive terms added in accord with section 7 apply 
to the code; keep intact all notices of the absence of any warranty; and give all 
recipients a copy of this License along with the Program. 


You may charge any price or no price for each copy that you convey, and you 
may offer support or warranty protection for a fee. 


. Conveying Modified Source Versions. 


You may convey a work based on the Program, or the modifications to produce 
it from the Program, in the form of source code under the terms of section 4, 
provided that you also meet all of these conditions: 


a. The work must carry prominent notices stating that you modified it, and 
giving a relevant date. 


b. The work must carry prominent notices stating that it is released under this 
License and any conditions added under section 7. This requirement modifies 
the requirement in section 4 to “keep intact all notices”. 


c. You must license the entire work, as a whole, under this License to anyone 
who comes into possession of a copy. This License will therefore apply, along 
with any applicable section 7 additional terms, to the whole of the work, and 
all its parts, regardless of how they are packaged. This License gives no per- 
mission to license the work in any other way, but it does not invalidate such 
permission if vou have sevaratelv received it. 





d. If the work has interactive user interfaces, each must display Appropriate 
Legal Notices; however, if the Program has interactive interfaces that do not 
display Appropriate Legal Notices, your work need not make them do so. 


A compilation of a covered work with other separate and independent works, 
which are not by their nature extensions of the covered work, and which are 
not combined with it such as to form a larger program, in or on a volume of a 
storage or distribution medium, ls called an “aggregate” if the compilation and 
its resulting copyright are not used to limit the access or legal rights of the com- 
pilation’s users beyond what the individual works permit. Inclusion of a covered 
work in an aggregate does not cause this License to apply to the other parts of 
the aggregate. 

. Conveying Non-Source Forms. 


You may convey a covered work in object code form under the terms of sections 
4 and 5, provided that you also convey the machine-readable Corresponding 
Source under the terms of this License, in one of these ways: 


a. Convey the object code in, or embodied in, a physical product (including a 
physical distribution medium), accompanied by the Corresponding Source 
fixed on a durable physical medium customarily used for software interchange. 


b. Convey the object code in, or embodied in, a physical product (including 
a physical distribution medium), accompanied by a written offer, valid for 
at least three years and valid for as long as you offer spare parts or customer 
support for that product model, to give anyone who possesses the object 
code either (1) a copy of the Corresponding Source for all the software in 
the product that 1s covered by this License, on a durable physical medium 
customarily used for software interchange, for a price no more than your rea- 
sonable cost of physically performing this conveying of source, or (2) access 
to copy the Corresponding Source from a network server at no charge. 


c. Convey individual copies of the object code with a copy of the written offer 
to provide the Corresponding Source. This alternative is allowed only occa- 
sionally and noncommercially, and only if you received the object code with 
such an offer, in accord with subsection 6b. 


d. Convey the object code by offering access from a designated place (gratis or for 
a charge), and offer equivalent access to the Corresponding Source in the same 
way through the same place at no further charge. You need not require recipi- 
ents to copy the Corresponding Source along with the object code. If the place 
to copy the object code is a network server, the Corresponding Source may be 
on a different server (operated by you or a third party) that supports equivalent 
copying facilities, provided you maintain clear directions next to the object 
code saying where to find the Corresponding Source. Regardless of what server 
hosts the Corresponding Source, you remain obligated to ensure that it is avail- 
able for as long as needed to satisfy these requirements. 
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other peers where the object code and Corresponding Source of the work are 
being offered to the general public at no charge under subsection 6d. 


A separable portion of the object code, whose source code 1s excluded from the 
Corresponding Source as a System Library, need not be included in conveying 
the object code work. 


A “User Product” is either (1) a “consumer product”, which means any tangi- 
ble personal property which is normally used for personal, family, or household 
purposes, or (2) anything designed or sold for incorporation into a dwelling. In 


determining whether a product is a consumer product, doubtful cases shall be 
resolved in favor of coverage. For a particular product received by a particular 
user, “normally used” refers to a typical or common use of that class of product, 
regardless of the status of the particular user or of the way in which the partic- 
ular user actually uses, or expects or 1s expected to use, the product. A product 
is a consumer product regardless of whether the product has substantial com- 
mercial, industrial or non-consumer uses, unless such uses represent the only 
significant mode of use of the product. 


“Installation Information” for a User Product means any methods, procedures, 
authorization keys, or other information required to install and execute mod- 
ified versions of a covered work in that User Product from a modified version 
of its Corresponding Source. The information must suffice to ensure that the 
continued functioning of the modified object code is in no case prevented or 
interfered with solely because modification has been made. 


If you convey an object code work under this section 1n, or with, or specifically 
for use in, a User Product, and the conveying occurs as part of a transaction in 
which the right of possession and use of the User Product is transferred to the 
recipient in perpetuity or for a fixed term (regardless of how the transaction is 
characterized), the Corresponding Source conveyed under this section must be 
accompanied by the Installation Information. But this requirement does not apply 
if neither you nor any third party retains the ability to install modified object code 
on the User Product (for example, the work has been installed in ROM). 


The requirement to provide Installation Information does not include a require- 
ment to continue to provide support service, warranty, or updates for a work that 
has been modified or installed by the recipient, or for the User Product in which 
it has been modified or installed. Access to a network may be denied when the 
modification itself materially and adversely affects the operation of the network or 
violates the rules and protocols for communication across the network. 


Corresponding Source conveyed, and Installation Information provided, in 
accord with this section must be in a format that is publicly documented (and 
with an implementation available to the public in source code form), and must 
require no special password or key for unpacking, reading or copying. 


. Additional Terms. 


“Additional permissions” are terms that supplement the terms of this License by 


making exceptions from one or more of its conditions. Additional permissions 
that are applicable to the entire Program shall be treated as though they were 
included in this License, to the extent that they are valid under applicable law. If 
additional permissions apply only to part of the Program, that part may be used 


separately under those permissions, but the entire Program remains governed by 
this License without regard to the additional permissions. 

When you convey a copy of a covered work, you may at your option remove 
any additional permissions from that copy, or from any part of it. (Additional 
permissions may be written to require their own removal in certain cases when 
you modify the work.) You may place additional permissions on material, added 
by you to a covered work, for which you have or can give appropriate copyright 
permission. 


Notwithstanding any other provision of this License, for material you add to a 
covered work, you may (if authorized by the copyright holders of that material) 
supplement the terms of this License with terms: 


a. Disclaiming warranty or limiting liability differently from the terms of sec- 
tions 15 and 16 of this License; or 


b. Requiring preservation of specified reasonable legal notices or author attribu- 
tions in that material or in the Appropriate Legal Notices displayed by works 
containing it; or 


c. Prohibiting misrepresentation of the origin of that material, or requiring that 
modified versions of such material be marked in reasonable ways as different 
from the original version; or 


d. Limiting the use for publicity purposes of names of licensors or authors of the 
material; or 


e. Declining to grant rights under trademark law for use of some trade names, 
trademarks, or service marks; or 


f. Requiring indemnification of licensors and authors of that material by any- 
one who conveys the material (or modified versions of it) with contractual 
assumptions of liability to the recipient, for any liability that these contractual 
assumptions directly impose on those licensors and authors. 


All other non-permissive additional terms are considered “further restrictions” 
within the meaning of section 10. If the Program as you received it, or any part 
of it, contains a notice stating that it is governed by this License along with a 
term that is a further restriction, you may remove that term. If a license docu- 
ment contains a further restriction but permits relicensing or conveying under 
this License, you may add to a covered work material governed by the terms 

of that license document, provided that the further restriction does not survive 
such relicensing or conveying. 


If you add terms to a covered work in accord with this section, you must place, 
in the relevant source files, a statement of the additional terms that apply to those 
files, or a notice indicating where to find the applicable terms. 


Additional terms, permissive or non-permissive, may be stated in the form of a 
separately written license, or stated as exceptions; the above requirements apply 
either way. 


8. 


10. 


Termination. 


You may not propagate or modify a covered work except as expressly provided 
under this License. Any attempt otherwise to propagate or modify it is void, and 
will automatically terminate your rights under this License (including any patent 
licenses granted under the third paragraph of section 11). 


However, if you cease all violation of this License, then your license from a par- 
ticular copyright holder is reinstated (a) provisionally, unless and until the copy- 
right holder explicitly and finally terminates your license, and (b) permanently, 
if the copyright holder fails to notify you of the violation by some reasonable 
means prior to 60 days after the cessation. 


Moreover, your license from a particular copyright holder is reinstated perma- 
nently if the copyright holder notifies you of the violation by some reasonable 
means, this is the first time you have received notice of violation of this License 
(for any work) from that copyright holder, and you cure the violation prior to 30 
days after your receipt of the notice. 


Termination of your rights under this section does not terminate the licenses of 
parties who have received copies or rights from you under this License. If your 
rights have been terminated and not permanently reinstated, you do not qualify 
to receive new licenses for the same material under section 10. 


Acceptance Not Required for Having Copies. 


You are not required to accept this License in order to receive or run a copy 

of the Program. Ancillary propagation of a covered work occurring solely as a 
consequence of using peer-to-peer transmission to receive a copy likewise does 
not require acceptance. However, nothing other than this License grants you 
permission to propagate or modify any covered work. These actions infringe 
copyright if you do not accept this License. Therefore, by modifying or propa- 
gating a covered work, you indicate your acceptance of this License to do so. 


Automatic Licensing of Downstream Recipients. 


Each time you convey a covered work, the recipient automatically receives a 
license from the original licensors, to run, modify and propagate that work, 
subject to this License. You are not responsible for enforcing compliance by third 
parties with this License. 


An “entity transaction” is a transaction transferring control of an organization, 
or substantially all assets of one, or subdividing an organization, or merging 
organizations. If propagation of a covered work results from an entity transac- 
tion, each party to that transaction who receives a copy of the work also receives 
whatever licenses to the work the party’s predecessor in interest had or could 
give under the previous paragraph, plus a right to possession of the Correspond- 
ing Source of the work from the predecessor in interest, 1f the predecessor has it 
or can get it with reasonable efforts. 

You may not impose any further restrictions on the exercise of the rights granted 
or affirmed under this License. For example, you may not impose a license fee, 
royalty, or other charge for exercise of rights granted under this License, and you 


11. 


may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) 
alleging that any patent claim ls infringed by making, using, selling, offering for 
sale, or importing the Program or any portion of it. 


Patents. 


A “contributor” is a copyright holder who authorizes use under this License of 
the Program or a work on which the Program is based. The work thus licensed 
is called the contributor’s “contributor version”. 


A contributor’s “essential patent claims” are all patent claims owned or con- 
trolled by the contributor, whether already acquired or hereafter acquired, that 
would be infringed by some manner, permitted by this License, of making, 
using, or selling its contributor version, but do not include claims that would be 
infringed only as a consequence of further modification of the contributor ver- 
sion. For purposes of this definition, “control” includes the right to grant patent 
sublicenses in a manner consistent with the requirements of this License. 


Each contributor grants you a non-exclusive, worldwide, royalty-free patent 
license under the contributor’s essential patent claims, to make, use, sell, offer 
for sale, import and otherwise run, modify and propagate the contents of its 
contributor version. 


In the following three paragraphs, a “patent license” 1s any express agreement or 
commitment, however denominated, not to enforce a patent (such as an express 
permission to practice a patent or covenant not to sue for patent infringement). 
To “grant” such a patent license to a party means to make such an agreement or 
commitment not to enforce a patent against the party. 


If you convey a covered work, knowingly relying on a patent license, and the 
Corresponding Source of the work is not available for anyone to copy, free of 
charge and under the terms of this License, through a publicly available network 
server or other readily accessible means, then you must either (1) cause the Corre- 
sponding Source to be so available, or (2) arrange to deprive yourself of the benefit 
of the patent license for this particular work, or (3) arrange, in a manner consistent 
with the requirements of this License, to extend the patent license to downstream 
recipients. “Knowingly relying” means you have actual knowledge that, but for 
the patent license, your conveying the covered work in a country, or your recipi- 
ent’s use of the covered work in a country, would infringe one or more identifiable 
patents in that country that you have reason to believe are valid. 


If, pursuant to or in connection with a single transaction or arrangement, you 
convey, or propagate by procuring conveyance of, a covered work, and grant 

a patent license to some of the parties receiving the covered work authorizing 
them to use, propagate, modify or convey a specific copy of the covered work, 
then the patent license you grant is automatically extended to all recipients of the 
covered work and works based on it. 


A patent license is “discriminatory” if it does not include within the scope of its 
coverage, prohibits the exercise of, or is conditioned on the non-exercise of one 
or more of the rights that are specifically granted under this License. You mav 
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not convey a covered work if you are a party to an arrangement with a third 
party that is in the business of distributing software, under which you make 
payment to the third party based on the extent of your activity of conveying 
the work, and under which the third party grants, to any of the parties who 
would receive the covered work from you, a discriminatory patent license (a) in 
connection with copies of the covered work conveyed by you (or copies made 
from those copies), or (b) primarily for and in connection with specific prod- 
ucts or compilations that contain the covered work, unless you entered into that 
arrangement, or that patent license was granted, prior to 28 March 2007. 


Nothing in this License shall be construed as excluding or limiting any implied 
license or other defenses to infringement that may otherwise be available to you 
under applicable patent law. 


No Surrender of Others’ Freedom. 


If conditions are imposed on you (whether by court order, agreement or other- 
wise) that contradict the conditions of this License, they do not excuse you from 
the conditions of this License. If you cannot convey a covered work so as to sat- 
isfy simultaneously your obligations under this License and any other pertinent 
obligations, then as a consequence you may not convey it at all. For example, if 
you agree to terms that obligate you to collect a royalty for further conveying 
from those to whom you convey the Program, the only way you could satisfy 
both those terms and this License would be to refrain entirely from conveying 
the Program. 


Use with the GNU Affero General Public License. 


Notwithstanding any other provision of this License, you have permission to 
link or combine any covered work with a work licensed under version 3 of the 
GNU Affero General Public License into a single combined work, and to con- 
vey the resulting work. The terms of this License will continue to apply to the 
part which is the covered work, but the special requirements of the GNU Affero 
General Public License, section 13, concerning interaction through a network 
will apply to the combination as such. 


Revised Versions of this License. 


The Free Software Foundation may publish revised and/or new versions of the 


GNU General Public License from time to time. Such new versions will be 
similar in spirit to the present version, but may differ in detail to address new 


problems or concerns. 


Each version is given a distinguishing version number. If the Program specifies 
that a certain numbered version of the GNU General Public License “or any 
later version” applies to it, you have the option of following the terms and con- 
ditions either of that numbered version or of any later version published by the 
Free Software Foundation. If the Program does not specify a version number of 
the GNU General Public License, you may choose any version ever published by 
the Free Software Foundation. 


If the Program specifies that a proxy can decide which future versions of the GNU 


General Public License can be used, that proxy’s public statement of acceptance of 
a version permanently authorizes you to choose that version for the Program. 


Later license versions may give you additional or different permissions. How- 
ever, no additional obligations are imposed on any author or copyright holder as 
a result of your choosing to follow a later version. 


15. Disclaimer of Warranty. 


THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT 
PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE 
STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR 
OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT 
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRAN- 
TIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PER- 
FORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE 
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL 
NECESSARY SERVICING, REPAIR OR CORRECTION. 


16. Limitation of Liability. 


IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR 
AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR 
ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE 
PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR 
DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL 
OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR 
INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIM- 
ITED TO LOSS OF DATA OR DATA BEING RENDERED INACCU- 
RATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A 
FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER 
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS 
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 

17. Interpretation of Sections 15 and 16. 


If the disclaimer of warranty and limitation of liability provided above cannot 
be given local legal effect according to their terms, reviewing courts shall apply 
local law that most closely approximates an absolute waiver of all civil liability 
in connection with the Program, unless a warranty or assumption of liability 
accompanies a copy of the Program in return for a fee. 


END OF TERMS AND CONDITIONS 


How to Apply These Terms to Your New Programs 


If you develop a new program, and you want it to be of the greatest possible use to 
the public, the best way to achieve this is to make it free software which everyone can 
redistribute and change under these terms. 

To do so, attach the following notices to the program. It is safest to attach them to 


the start of each source file to most effectively state the exclusion of warranty; and each 
file should have at least the “copyright” line and a pointer to where the full notice is 
found. 


<one line to give the program’s name and a brief idea of what it does.> 


Copyright (C) <year> <name of author> 


This program ls free software: you can redistribute lt and/or modify it under 
the terms of the GNU General Public License as published by the Free Soft- 
ware Foundation, either version 3 of the License, or (at your option) any later 
version. 


This program ls distributed in the hope that it will be useful, but WITHOUT 
ANY WARRANTY; without even the implied warranty of MERCHANT- 
ABILITY or FITNESS FORA PARTICULAR. PUR-POSE. See the GNU 
General Public License for more details. 


You should have received a copy of the GNU General Public License along 
with this program. If not, see <http://www.gnu.org/licenses/>. 


Also add information on how to contact you by electronic and paper mail. 
If the program does terminal interaction, make it output a short notice like this 
when it starts in an interactive mode: 


<program> Copyright (C) <year> <name of author> 

This program comes with ABSOLUTELY NO WARRANTY; for details 
type ‘show w'. 

This is free software, and you are welcome to redistribute it under certain 
conditions; type ‘show c' for details. 


The hypothetical commands ‘show w' and ‘show c' should show the appropriate 
parts of the General Public License. Of course, your program’s commands might be 
different; for a GUI interface, you would use an “about box”. 

You should also get your employer (if you work as a programmer) or school, if any, to 
sign a “copyright disclaimer” for the program, if necessary. For more information on this, 
and how to apply and follow the GNU GPL, see <http://www.gnu.org/licenses/>. 

The GNU General Public License does not permit incorporating your program into 
proprietary programs. If your program 1s a subroutine library, you may consider it more 
useful to permit linking proprietary applications with the library. If this is what you 
want to do, use the GNU Lesser General Public License instead of this License. But 
first, please read <http://www.gnu.org/philosophy/why-not-lgpl.html>. 


AA Apache License Version 2.0 


Apache License 
Version 2.0, January 2004 
http://www.apache.org/licenses/ 


TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 


1. Definitions. 


“License” shall mean the terms and conditions for use, reproduction, and distri- 
bution as defined by Sections 1 through 9 of this document. 


“Licensor” shall mean the copyright owner or entity authorized by the copy- 
right owner that is granting the License. 


“Legal Entity” shall mean the union of the acting entity and all other entities 
that control, are controlled by, or are under common control with that entity. 
For the purposes of this definition, “control” means (i) the power, direct or 
indirect, to cause the direction or management of such entity, whether by 
contract or otherwise, or (11) ownership of fifty percent (50%) or more of the 
outstanding shares, or (111) beneficial ownership of such entity. 


“You” (or “Your’’) shall mean an individual or Legal Entity exercising permis- 
sions granted by this License. 


“Source” form shall mean the preferred form for making modifications, includ- 
ing but not limited to software source code, documentation source, and config- 
uration files. 


“Object” form shall mean any form resulting from mechanical transformation or 
translation of a Source form, including but not limited to compiled object code, 
generated documentation, and conversions to other media types. 


“Work” shall mean the work of authorship, whether in Source or Object form, 
made available under the License, as indicated by a copyright notice that is included 
in or attached to the work (an example is provided in the Appendix below). 


“Derivative Works” shall mean any work, whether in Source or Object form, 
that is based on (or derived from) the Work and for which the editorial revisions, 
annotations, elaborations, or other modifications represent, as a whole, an origi- 
nal work of authorship. For the purposes of this License, Derivative Works shall 
not include works that remain separable from, or merely link (or bind by name) 
to the interfaces of, the Work and Derivative Works thereof. 


“Contribution” shall mean any work of authorship, including the original ver- 
sion of the Work and any modifications or additions to that Work or Derivative 
Works thereof, that is intentionally submitted to Licensor for inclusion in the 
Work by the copyright owner or by an individual or Legal Entity authorized 
to submit on behalf of the copyright owner. For the purposes of this definition, 
“submitted” means any form of electronic, verbal, or written communication 
sent to the Licensor or its representatives, including but not limited to com- 
munication on electronic mailing lists, source code control systems, and issue 
tracking systems that are managed by, or on behalf of, the Licensor for the pur- 
pose of discussing and improving the Work, but excluding communication that 
is conspicuously marked or otherwise designated in writing by the copyright 
owner as “Not a Contribution.” 


“Contributor” shall mean Licensor and any individual or Legal Entity on behalf 


of whom a Contribution has been received by Licensor and subsequently incor- 
porated within the Work. 


2. Grant of Copyright License. 


Subject to the terms and conditions of this License, each Contributor hereby 
grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, 
irrevocable copyright license to reproduce, prepare Derivative Works of, pub- 
licly display, publicly perform, sublicense, and distribute the Work and such 
Derivative Works in Source or Object form. 


3. Grant of Patent License. 


Subject to the terms and conditions of this License, each Contributor hereby 
grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, 
irrevocable (except as stated in this section) patent license to make, have made, 
use, offer to sell, sell, import, and otherwise transfer the Work, where such 
license applies only to those patent claims licensable by such Contributor that are 
necessarily infringed by their Contribution(s) alone or by combination of their 
Contribution(s) with the Work to which such Contribution(s) was submitted. 

If You institute patent litigation against any entity (including a cross-claim or 
counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated 
within the Work constitutes direct or contributory patent infringement, then 
any patent licenses granted to You under this License for that Work shall termi- 
nate as of the date such litigation 1s filed. 


4. Redistribution. 


You may reproduce and distribute copies of the Work or Derivative Works 
thereof in any medium, with or without modifications, and in Source or Object 
form, provided that You meet the following conditions: 


a. You must give any other recipients of the Work or Derivative Works a copy 
of this License; and 


b. You must cause any modified files to carry prominent notices stating that 
You changed the files; and 


c. You must retain, in the Source form of any Derivative Works that You 
distribute, all copyright, patent, trademark, and attribution notices from the 
Source form of the Work, excluding those notices that do not pertain to any 
part of the Derivative Works; and 


d. If the Work includes a “NOTICE” text file as part of its distribution, then 
any Derivative Works that You distribute must include a readable copy 
of the attribution notices contained within such NOTICE file, excluding 
those notices that do not pertain to any part of the Derivative Works, in at 
least one of the following places: within a NOTICE text file distributed as 
part of the Derivative Works; within the Source form or documentation, if 
provided along with the Derivative Works; or, within a display generated 
by the Derivative Works, if and wherever such third-party notices normally 
appear. The contents of the NOTICE file are for informational purposes only 


and do not modify the License. You may add Your own attribution notices 
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the NOTICE text from the Work, provided that such additional attribution 
notices cannot be construed as modifying the License. 


You may add Your own copyright statement to Your modifications and may 
provide additional or different license terms and conditions for use, reproduc- 
tion, or distribution of Your modifications, or for any such Derivative Works as 
a whole, provided Your use, reproduction, and distribution of the Work other- 
wise complies with the conditions stated in this License. 


. Submission of Contributions. 


Unless You explicitly state otherwise, any Contribution intentionally submitted 
for inclusion in the Work by You to the Licensor shall be under the terms and 
conditions of this License, without any additional terms or conditions. Notwith- 
standing the above, nothing herein shall supersede or modify the terms of any 
separate license agreement you may have executed with Licensor regarding such 
Contributions. 

. Trademarks. 


This License does not grant permission to use the trade names, trademarks, ser- 
vice marks, or product names of the Licensor, except as required for reasonable 
and customary use in describing the origin of the Work and reproducing the 
content of the NOTICE file. 


. Disclaimer of Warranty. 


Unless required by applicable law or agreed to in writing, Licensor provides the 
Work (and each Contributor provides its Contributions) on an “AS IS” BASIS, 
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 
express or implied, including, without limitation, any warranties or conditions 
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS 
FOR A PARTICULAR PURPOSE. You are solely responsible for determin- 
ing the appropriateness of using or redistributing the Work and assume any risks 
associated with Your exercise of permissions under this License. 


. Limitation of Liability. 


In no event and under no legal theory, whether in tort (including negligence), 
contract, or otherwise, unless required by applicable law (such as deliberate and 
grossly negligent acts) or agreed to in writing, shall any Contributor be liable to 
You for damages, including any direct, indirect, special, incidental, or conse- 
quential damages of any character arising as a result of this License or out of the 
use or inability to use the Work (including but not limited to damages for loss of 
goodwill, work stoppage, computer failure or malfunction, or any and all other 
commercial damages or losses), even if such Contributor has been advised of the 
possibility of such damages. 


. Accepting Warranty or Additional Liability. 


While redistributing the Work or Derivative Works thereof, You may choose 
to offer, and charge a fee for, acceptance of support, warranty, indemnity, or 


other liability obligations and/or rights consistent with this License. However, 
in accepting such obligations, You may act only on Your own behalf and on 
Your sole responsibility, not on behalf of any other Contributor, and only if You 
agree to indemnify, defend, and hold each Contributor harmless for any liabil- 
ity incurred by, or claims asserted against, such Contributor by reason of your 
accepting any such warranty or additional liability. 


END OF TERMS AND CONDITIONS 


APPENDIX: How to Apply the Apache License to Your Work 


To apply the Apache License to your work, attach the following boilerplate notice, with 
the fields enclosed by brackets “[]” replaced with your own identifying information. 
(Don’t include the brackets!) The text should be enclosed in the appropriate comment 
syntax for the file format. We also recommend that a file or class name and description 
of purpose be included on the same “printed page” as the copyright notice for easier 
identification within third-party archives. 


Copyright [yyyy] [name of copyright owner] 


Licensed under the Apache License, Version 2.0 (the “License’’); you may not 
use this file except in compliance with the License. You may obtain a copy of 


the License-at 
http://www.apache.org/licenses/ LICENSE-2.0 


Unless required by applicable law or agreed to in writing, software distributed 
under the License is distributed on an “AS IS” BASIS WITHOUT WAR- 
RANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
See the License for the specific language governing permissions and limita- 
tions under the License. 


[1] https://opensoutce.org. 


WRB 元 数据 参考 


表 B-1 和 B-2 分 别 列 出 层 和 机 器 ， 它 们 显示 在 接 下 来 的 页 面 中 。 为 了 获得 可 搜索 的 参考 ， 请 访 
ieJhttp://layers.openembedded.org/layerindex/branch/master/layers/, 


表 B-1 Æ 


层 名 
meta-oe 
openembedded-core 
e100-bsp 
e300-bsp 
meta-aarch64 
meta-acer 
meta-altera 
meta-amd 
meta-asus 
meta-atmel 
meta-baldeagle 
meta-beagleboard 
meta-bug 
meta-bytesatwork 
meta-chip 
meta-ci20 
meta-crownbay 
meta-crystalforest 
meta-cubox 


meta-digi-arm 


meta-dra7xx-evm 


meta-efikamx 


meta-emenlow 
meta-exynos 
meta-fri2 
meta-fsl-arm 
meta-fsl-arm-extra 
meta-fsl-ppc 
meta-geeksphone 
meta-gumstix 


meta-gumstix- 
community 


meta-gumstix-extras 


meta-handheld 


meta-hipos 


meta-htc 
meta-igep 
meta-intel 


meta-intel-edison- 
bsp 


meta-intel-quark 
meta-ivi-bsp 
meta-jasperforest 
meta-jz-mips 
meta-kirkwood 


meta-lsi 


Additional shared OpenEmbedded (OE) metadata 


Core metadata 


Ettus E1XX series board support package (BSP) 


描述 


Ettus E3XX Series BSP 


AArch64 (64-bit ARM) architecture support 


Acer machines support 


Altera SoC BSP layer 


AMD board support common layer (official) 


Asus machines support 


Official Yocto Project layer for Atmel SoCs 

AMD Bald Eagle platform BSP 

Support for beagleboard.org devices 

BugLabs bug20 machine support 

Official BSP layer for Bytesatwork-based platform 
Yocto BSP layer for CHIP boards 

Meta layer to support Creator C120 MIPS boards 
Intel Crown Bay platform BSP 

Intel Crystal Forest platform BSP 

SolidRun CuBox platform BSP 


Support for Digi ConnectCore/ConnectCard 


modules 


Tizen BSP layer for DRA7XX-EVM 


Genesi Efika MX machine support 


Intel eMenlow platform BSP 

BSP layer for Exynos-based machines 

Kontron Fish River Island 2 BSP 

Freescale ARM hardware support 

Freescale ARM hardware support (extra boards) 
Freescale PowerPC hardware support 
Geeksphone device support 

Gumstix board support (official) 


Gumstix board support (unofficial community BSP) 


Gumstix board support extras (official) 
Older handheld device support (Zaurus, iPAQ, etc.) 


BSP and related Distro for embedded devices 
from the DResearch Fahrzeugelektronik GmbH 


HTC smartphone support 
IGEP board support 
Intel board support common layer (official) 


Intel Edison module support 


Intel Quark platform support 

BSP layer for IVI reference hardware 
Intel Jasper Forest platform BSP 

BSP for devices with Ingenic MIPS SoC 


Marvell Kirkwood-based device support 


LSI Axxia Communication Processors Platform BSP 


类 型 
Base 
Base 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 


Machine (BSP) 


仓库 
git://git.openembedded.org/meta-openembedded 


git://git.openembedded.org/openembedded-core 
git://github.com/EttusResearch/meta-ettus.git 
https://github.com/EttusResearch/meta-ettus.git 
git://git.linaro.org/openembedded/meta-linaro.git 
git://github.com/shr-distribution/meta-smartphone.git 
https://github.com/kraj/meta-altera 
git://git.yoctoproject.org/meta-amd 
git://github.com/shr-distribution/meta-smartphone.git 
git://github.com/linux4sam/meta-atmel.git 
http://git.yoctoproject.org/cgit/cgit.cgi/meta-amd/ 
git://github.com/beagleboard/meta-beagleboard.git 
git://github.com/buglabs/meta-bug.git 
https://github.com/bytesatwork/meta-bytesatwork.git 
https://github.com/agherzan/meta-chip.git 
https://github.com/akuster/meta-ci20 
git://git.yoctoproject.org/meta-intel 
git://git.yoctoproject.org/meta-intel 
git://github.com/dv1/meta-cubox.git 
https://github.com/dgii/meta-digi.git 


https://github.com/vitalyvch/meta-dra7xx-evm.git 


git://github.com/kraj/meta-efikamx.git 


git://git.yoctoproject.org/meta-intel 
https://github.com/slimlogic/meta-exynos.git 
git://git.yoctoproject.org/meta-intel 
git://git.yoctoproject.org/meta-fsl-arm 
git://github.com/Freescale/meta-fsl-arm-extra.git 
git://git.yoctoproject.org/meta-fsl-ppc 
git://github.com/shr-distribution/meta-smartphone.git 
git://github.com/gumstix/meta-gumstix.git 


https://github.com/schnitzeltony/meta-gumstix-community 


https://github.com/gumstix/meta-gumstix-extras.git 
git://git.openembedded.org/meta-handheld 
git://github.com/DFE/meta-hipos.git 


git://github.com/shr-distriobution/meta-smartphone. git 
git://github.com/ebutera/meta-igep.git 
git://git.yoctoproject.org/meta-intel 


git://git.yoctoproject.org/meta-intel-edison 


git://git.yoctoproject.org /meta-intel-quark 
git://git.yoctoproject.org/meta-ivi 
git://git.yoctoproject.org/meta-intel 
https://github.com/leon-anavi/meta-jz-mips. git 
git://github.com/kelvinilawson/meta-kirkwood.git 


git://git.yoctoproject.org/meta-lsi 


层 名 
meta-minnow 
meta-nanopi 
meta-netbookpro 
meta-netmodule 
meta-nokia 
meta-nslu2 
meta-nuc 


meta-odroid 


meta-openmoko 
meta-openpandora 
meta-ouya 
meta-palm 
meta-parallella 
meta-phytec 
meta-picosam9 
meta-qemu-bsps 
meta-raspberrypi 
meta-renesas-rzal 


meta-rockchip 


meta-romley 
meta-samsung 
meta-sugarbay 


meta-sunxi 


meta-ti 
meta-via-vab820-bsp 
meta-xilinx 


meta-xilinx- 
community 


meta-yocto-bsp 
meta-yocto-bsp-old 
meta-angstrom 
meta-arago-distro 
meta-debian 


meta-digi-dey 


meta-eca 
meta-eldk 
meta-guacamayo 


meta-intel-edison- 
distro 


meta-intel-iot- 
devkit 


meta-ivi 


meta-luneos 
meta-luv 


meta-mel 


meta-micro 


描述 
MinnowBoard BSP layer 


FriendlyARM NanoPi board support 

Psion NetBook Pro device support 

BSP Layer from NetModule for various boards 
Nokia N900 support 

Linksys NSLU2 device support 

Intel Next Unit of Computing BSP 


Supports the series of Odroid boards made by 
Hardkernel 


OpenMoko device support 

OpenPandora machine support 

Support Ouya game console 

Palm Pre machine support 

Support for the Parallella board from Adapteva 
Phytec board support (official) 

Picosam9 board support 

Layer for other QEMU machines 

Raspberry Pi board support 

Official BSP layer for Renesas RZ/A1 platforms 


Layer supporting public Rockchip-based 
development boards and products 


Intel Romley platform BSP 
Samsung smartphone support 
Intel Sugar Bay platform BSP 


Allwinner sunxi board support 


Texas Instruments board support (official) 
VIA VAB-820/AMOS-820 BSP layer 
Xilinx hardware support 


Additional Xilinx hardware support 


BSP layer for Yocto Project reference hardware 
Former Yocto Project reference BSPs 
Ångström distribution 

Arago/TI-SDK distribution 

Using Debian source code to BitBake images 


Provides the Digi Embedded Linux distribution 
images 


Mobile access point 
Denx ELDK distribution 
Guacamayo distribution 


Distro layer for official Intel Edison images 


Distro layer for the Intel lof Developer Kit 


Collection of software related to in-vehicle 
infotainment systems 


Distro layer for LuneOS 
luvOS distribution 


Mentor Embedded Linux distribution (from 
Mentor Graphics Corporation) 


Micro distribution 


类 型 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 
Machine (BSP) 
Machine (BSP) 


Machine (BSP) 
Machine (BSP) 
Distribution 
Distribution 
Distribution 


Distribution 


Distribution 
Distribution 
Distribution 


Distribution 


Distribution 


Distribution 


Distribution 
Distribution 


Distribution 


Distribution 


仓库 


git://git.yoctoproject.org/meta-minnow 
git://git.kernelconcepts.de/meta-nanopi.git 
git://github.com/tworaz/meta-netbookpro 
https://github.com/netmodule/meta-netmodule.git 
git://github.com/shr-distribution/meta-smartphone.git 
git://github.com/kraj/meta-nslu2 
git://git.yoctoproject.org/meta-intel 


https://github.com/akuster/meta-odroid 


git://github.com/shr-distribution/meta-smartphone.git 
git://github.com/openpandora/meta-openpandora.git 
https ://github.com/pwgen/meta-ouya 
git://github.com/shr-distribution/meta-smartphone.git 
https://github.com/nathanrossi/meta-parallella.git 
git://git.phytec.de/meta-phytec 

https ://gitorious.org/picopc-tools/meta-picosam9.git 
https ://github.com/akuster/meta-qemu-bsps 
git://git.yoctoproject.org/meta-raspberrypi 
git://github.com/renesas-rz/meta-renesas-rza1 


git://git.yoctoproject.org/meta-rockchip 


git://git.yoctoproject.org/meta-intel 
git://github.com/shr-distribution/meta-smartphone.git 
git://git.yoctoproject.org/meta-intel 


https ://github.com/linux-sunxi/meta-sunxi 


git://git.yoctoproject.org/meta-ti 
git://github.com/viaembedded/meta-via-vab820-bsp.git 
git://git.yoctoproject.org /meta-xilinx 


git://git.yoctoproject.org/meta-xilinx-community 


git: //git.yoctoproject.org/meta-yocto 
git://git.yoctoproject.org/meta-yocto-bsp-old 
git://github.com/Angstrom-distribution/meta-angstrom.git 
git: //arago-project.org/git/meta-arago. git 
git://github.com/meta-debian/meta-debian.git 


https://github.com/dgii/meta-digi 


git://git.yoctoproject.org/meta-eca 
git://git.denx.de/eldk.git 
git://github.com/Guacamayo/meta-guacamayo. git 


git://git.yoctoproject.org/meta-intel-edison 


git://git.yoctoproject.org /meta-intel-iot-devkit 


git://git.yoctoproject.org/meta-ivi 


https://github.com/webOS-ports/meta-webos-ports 
git://git.yoctoproject.org/meta-luv 


https://github.com/MentorEmbedded/meta-mentor 


git://git.openembedded.org/meta-micro 


层 名 


meta-mmmpi 


meta-overc 


meta-shr-distro 


meta-slugos 
meta-tizen 


meta-webos 


meta-webos-ports 


meta-woce 


meta-yocto 


meta-alt-desktop- 


extras 
meta-axon 
meta-baryon 


meta-cgl 


meta-darwin 


meta-gir 


meta-intel-galileo 


meta-kernel-dev 


meta-linaro 


meta-mentor-staging 


meta-mingw 


meta-pareon 


meta-ro-rootfs 


meta-security-isafw 


meta-security- 


rockwell 


meta-tlk 


meta-ada 


meta-android 
meta-arago-extras 


meta-aspnet 


meta-audio 


meta-aurora 


meta-beagleboard- 


extras 


meta-browser 


meta-buglabs 


meta-chicken 


meta-ci 


meta-clang 


meta-cloud-services 


meta-clutter 


meta-cpan 


meta-crosswalk 


meta-efl 


An example distro layer customized for the 


Raspberry Pi 


Full-featured, container-based distribution 
SHR distribution 

SlugOS distribution 

Tizen reference for the Yocto Project 


WebOS distribution (official) 


Distro layer for LuneOS 


WebOS Community Edition distribution 
Poky reference distribution for the Yocto Project 


Lightweight (legacy) X desktop, tools, and recipe 


extensions 


Using Erlang on YP 

Baryon example NAS distribution 

Carrier Grade Linux compliance packages 
OE meta layer for darwin-based SDKs 


GObject Introspection Support 


Intel Galileo platform support 

Kernel development extras 

Linaro layer for OE 

Mentor Graphics Staging Layer for Yocto/OE 

OE meta layer for mingw-based SDKs 

This layer automates using Pareon Verify with OE 


Staging area for improvements to read-only- 


rootfs handling 


Image Security Analyser FW layer 


OE layer that assists developers in hardening 
their Yocto-built systems, focusing on the Daisy 


release 


Time-limited kernel layer 


Ada support 


Android-specific tools 


Arago/Tl extra apps 


ASP.NET 5 


Contains recipes for various audio DSP tools 


Aurora Ul 


BeagleBoard extras 


Web browsers (Chromium, Firefox, etc.) 


BugLabs middleware and specific OSGi 


components 


Chicken toolchain support 
The OE/Yocto BSP layer for Cl-related things 


Clang/LLVM alternative to gcc for C/C++ cross 


compiler 


General package support for cloud and 


clustering development 


Recipes for Cogl, Clutter, and friends 
CPAN distributions as meant by CPAN authors 


Web runtime for ambitious HTML5 applications 


Enlightenment UI support 


类 型 


Distribution 


Distribution 
Distribution 
Distribution 
Distribution 
Distribution 
Distribution 
Distribution 
Distribution 


Miscellaneous 


Miscellaneous 
Miscellaneous 
Miscellaneous 
Miscellaneous 


Miscellaneous 


Miscellaneous 
Miscellaneous 
Miscellaneous 
Miscellaneous 
Miscellaneous 
Miscellaneous 


Miscellaneous 


Miscellaneous 


Miscellaneous 


Miscellaneous 
Software 
Software 
Software 
Software 
Software 
Software 


Software 


Software 


Software 


Software 
Software 


Software 


Software 


Software 
Software 
Software 


Software 


仓库 
https://bitbucket.org/mmmpi/meta-mmmpi.git 


git://github.com/WindRiver-OpenSourceLabs/meta-overc.git 
git://github.com/shr-distribution/meta-smartphone.git 
git://github.com/kraj/meta-slugos 
git://review.tizen.org/scm/bb/meta-tizen 
git://github.com/openwebos/meta-webos 
https://github.com/webOS-ports/meta-webos-ports 
git://github.com/kraj/meta-woce 
git://git.yoctoproject.org/meta-yocto 


https://github.com/sarnold/meta-alt-desktop-extras 


https://github.com/joaohf/meta-axon 
git://git.yoctoproject.org/meta-baryon 
git://git.yoctoproject.org/meta-cgl 

git://git-yoctoproject.org/meta-darwin 


git://github.com/meta-gir/meta-gir.git 
git: //git.yoctoproject.org /meta-intel-galileo 


git: //git.yoctoproject.org /meta-yocto-kernel-extras 
git: //git.linaro.org /openembedded/meta-linaro. git 
https ://github.com/MentorEmbedded/meta-mentor 
git: //git.yoctoproject.org /meta-mingw 

https ://github.com/vectorfabrics /meta-pareon 


https ://github.com/MentorEmbedded/meta-ro-rootfs 


https://github.com/O1org/meta-security-isafw 


https://github.com/IrdetoServices/meta-security-rockwell.git 


git://git.yoctoproject.org/meta-intel 
git://github.com/Lucretia/meta-ada.git 
git://github.com/shr-distribution/meta-smartphone.git 
git: //arago-project.org /git/meta-arago.git 
git://github.com/Tragetaschen/meta-aspnet.git 
https://github.com/errordeveloper/oe-meta-audio 
git://github.com/shr-distribution/meta-smartphone.git 


git: //github.com/beagleboard/meta-beagleboard 


git://github.com/OSSystems/meta-browser.git 


git://github.com/buglabs/meta-buglabs.git 


git://github.com/OSSystems/meta-chicken 
https://github.com/koenkooi/meta-ci.git 


https://github.com/kraj/meta-clang 


git://git.yoctoproject.org /meta-cloud-services 


git://github.com/Guacamayo/meta-clutter.git 
https://github.com/rehsack/meta-cpan.git 
git://github.com/crosswalk-project/meta-crosswalk 


git://git.openembedded.org/meta-openembedded 


层 名 
meta-erlang 
meta-filesystems 


meta-fsl-demos 


meta-fso 


meta-game-emulators 


meta-games 
meta-gnome 


meta-go 


meta-gpe 
meta-gstreamer10 


meta-hamradio 
meta-initramfs 


meta-intel-iot- 
middleware 


meta-iot 


meta-ivi-demo 
meta-java 
meta-kali 
meta-kde4 
meta-kf£5 


meta-linaro- 
toolchain 


meta-luneui 


meta-lxcbench 
meta-maker 


meta-measured 


meta-mel-support 


meta-mono 
meta-multimedia 
meta-musl 


meta-netmodule- 
extras 
meta-networking 


meta-office 


meta-oic 
meta-openclovis 
meta-openhab 
meta-openstack 


meta-openstack- 
compute-deploy 


meta-openstack- 


controller-deploy 


meta-openstack-qemu 


meta-openwrt 


meta-opie 


描述 
Erlang Support 


Support for additional filesystems 


OE/Yocto layer for Freescale’s demonstration 


images 


Freesmartphone.org framework support 


Software layer for video game system emulators 


Open source games 


GNOME UI support 


Provides support for cross-compiling programs 


written in Go language 
GPE UI support (very minimal currently) 
OE layer for GStreamer 1.0 


Ham radio-related software 


initramfs tools 


Shared middleware recipes for Intel loT 
platforms 


Provides support for building an Internet of 
Things device manager and translator 


GENIVI Yocto Demo Platform 
Java support 

Kali penetration test tools 
KDE 4/Plasma Active 

KDE Frameworks 5 


Linaro toolchain support 


Recipes for LuneOS UI 


Yocto layer for the LXCBENCH project 


OE recipes for makers 


Tools and utilities related to measuring software 


and trusted computing 


Mentor Embedded Linux Support Layer for 
Yocto/OE 


Mono 
Multimedia-related software 
Support for the musl C library 


Additional packets used by NetModule 


Network-related software 
Office applications and libs 


Support for building the Open Interconnect 
Consortium lotivity framework 


Layer to support SAFplus middleware 
components 


Yocto layer providing openHAB (home 
automation software) 


OpenStack support 


OpenStack compute node support 


OpenStack controller node support 


OpenStack QEMU image support 
OE metadata for OpenWRT packages 
Opie UI support 


类 型 


Software 
Software 


Software 


Software 
Software 
Software 
Software 


Software 


Software 
Software 


Software 


Software 


Software 


Software 


Software 
Software 
Software 
Software 
Software 


Software 


Software 


Software 
Software 


Software 


Software 


Software 
Software 
Software 


Software 


Software 
Software 


Software 


Software 


Software 


Software 


Software 


Software 


Software 
Software 


Software 


仓库 
https://github.com/joaohf/meta-erlang 


git: //git.openembedded.org/meta-openembedded 


https://github.com/Freescale/meta-fsl-demos. git 


git: //github.com/shr-distribution /meta-smartphone.git 
https://github.com/sergioprado/meta-game-emulators 
git://github.com/cazfi/meta-games.git 

git: //git.openembedded.org /meta-openembedded 


https://github.com/errordeveloper/oe-meta-go 


git: //git.openembedded.org/meta-openembedded 
git: //github.com/dv1/meta-gstreamer1.0O.git 


https://github.com/hambedded-linux/meta-hamradio.git 
git://git.openembedded.org/meta-openembedded 


git://git.yoctoproject.org /meta-intel-iot-middleware 


https://github.com/cablelabs /meta-iot 


git://git.yoctoproject.org/meta-ivi 
git://git.yoctoproject.org/meta-java 
https://github.com/akuster/meta-kali 
https://bitbucket.org/gen_dev_sst/meta-kde4.git 
https://github.com/e8johan/meta-kf5.git 


git://git.linaro.org/openembedded/meta-linaro.git 


https ://github.com/webOS-ports/meta-webos-ports 


git://git.projects.genivi.org/Ixcbench.git 
http://git.yoctoproject.org/git/meta-maker 
https://github.com/flinp/meta-measured.git 


https://github.com/MentorEmbedded/meta-mentor 


git://git.yoctoproject.org/meta-mono 
git://git.openembedded.org/meta-openembedded 
https://github.com/kraj/meta-musl.git 


https://github.com/netmodule/meta-netmodule-extras. git 


git://git.openembedded.org/meta-openembedded 
git://github.com/schnitzeltony/meta-office.git 


git://git.yoctoproject.org/meta-oic 


https://github.com/joaohf/meta-openclovis 


https://github.com/ulfwin/meta-openhab 


git://git.yoctoproject.org/meta-cloud-services 


git://git.yoctoproject.org/meta-cloud-services 


git://git.yoctoproject.org/meta-cloud-services 


git://git.yoctoproject.org/meta-cloud-services 
https://github.com/kraj/meta-openwrt 


git://git.openembedded.org/meta-opie 


Re 


git://git.yoctoproject.org/meta-oracle-java 


meta-oracle-java 
meta-osmocombb 
meta-perl 


meta-pypy 


meta-python 
meta-qt3 


meta-qt4 
meta-qt5 


meta-qt5-extra 


meta-realtime 
meta-ros 
meta-ruby 
meta-rust 
meta-sdr 
meta-security 


meta-security- 
framework 


meta-security-smack 
meta-selinux 
meta-shr 
meta-smalltalk 


meta-sourcery 


meta-spec 


meta-swupdate 
meta-systemd 
meta-telephony 


meta-telldus 


meta-tracing 


meta-uav 


meta-virtualization 


meta-web-kiosk 


meta-webkit 


meta-webserver 


meta-wolfssl 


meta-x10 
meta-xfce 


toolchain-layer 


Oracle Java support 
OsmocomBB support 
Additional Perl recipes 


Cross/Embedded PyPy (https://bitoucket.org/ 
pypy/pypy) support 


Python support 
Qt 3.x Support 


Qt 4.x support 
Qt5 modules 


Desktop environments and applications based 
on qt5 


Additional real-time support 

Robot Operating System (ROS) support layer 
Ruby support 

Rust compiler and package manager 
Software-defined radio (SDR)-related recipes 
Security tools for Internet connected devices 


Adds higher-level security middleware and tools 


Adds the Smack LSM to OE distros 
SELinux support 

SHR applications 

GNU Smalltalk and ports 


CodeSourcery toolchain support layer by Mentor 
Graphics Corporation 


Support for the Simple PCle FMC Carrier (SPEC) 


Layer supporting Software Update via swupdate 
systemd support 
Telephony-related software 


TellStick support layer 


Layer to add necessary agent support for 
Sourcery Analyzer (Ittng+systemtap bits) 


Software for drones 


Hypervisor, virtualization tool stack, and cloud 
support 


Layer enabling browser-based kiosk devices 
with virtual keyboard support 


WebKit engines and browsers: 
WebkitForWayland, WebKitGTK+ 


Web server-related software 


Lightweight, portable, C-language-based SSL/ 
TLS library 


x10 protocol related software 
XFCE UI support 


Older/newer toolchains 


表 B-2 


类 型 


Software 
Software 
Software 


Software 


Software 
Software 


Software 
Software 


Software 


Software 
Software 
Software 
Software 
Software 
Software 


Software 


Software 
Software 
Software 
Software 


Software 


Software 


Software 
Software 
Software 


Software 


Software 


Software 


Software 


Software 


Software 


Software 


Software 


Software 
Software 


Software 


>- 
=) 

Ws 
TS 


仓库 


git://github.com/shr-distrioution/meta-smartphone.git 
git://git.openembedded.org /meta-openembedded 
https://github.com/mzakharo/meta-pypy. git 


git://git.openembedded.org/meta-openembedded 
git://git.yoctoproject.org/meta-qt3 


git://git.yoctoproject.org/meta-qt4 
git://github.com/meta-qt5/meta-qt5.git 


git://github.com/schnitzeltony/meta-qt5-extra.git 


git://git.yoctoproject.org/meta-realtime 
git://github.com/bmwcarit/meta-ros. git 
git://git.openembedded.org/meta-openembedded 
https://github.com/starlab-io/meta-rust. git 
https://github.com/balister/meta-sdr.git 
git://git.yoctoproject.org/meta-security 


https://github.com/O1org/meta-intel-iot-security.git 


https://github.com/O1org/meta-intel-iot-security. git 
git://git.yoctoproject.org/meta-selinux 
git://github.com/shr-distribution/meta-smartphone.git 
git://github.com/sysmocom/meta-smalltalk.git 


git://github.com/MentorEmbedded/meta-sourcery.git 


git://ohwr.org/fmc-projects /spec/spec-getting-started/ 
meta-spec. git 
https://github.com/sbabic/meta-swupdate 
git://git.openembedded.org/meta-openembedded 
https://github.com/sysmocom/meta-telephony 


https://github.com/maxinbjohn/meta-telldus 
git://github.com/MentorEmbedded/meta-tracing.git 


https://github.com/koenkooi/meta-uav.git 


git://git.yoctoproject.org /meta-virtualization 


git://git.yoctoproject.org/meta-web-kiosk 


https://github.com/lgalia/meta-webkit 


git: //git.openembedded.org/meta-openembedded 
https://github.com/wolfSSL/meta-wolfss| 


git://github.com/baillaw/meta-x10. git 
git://git.openembedded.org/meta-openembedded 


git://git.openembedded.org/meta-openembedded 


机 器 名 


a500 

akita 
am180x-evm 
am335x-evm 
am3517-evm 
am37x-evm 
am437x-evm 
am57xx-evm 
apalis-imx6 
arago 
arago-armv5 
arago-armv7 
arndale 
arndale-octa 
arria10 


arria5 


at91sam9m10g45ek 


at91sam9rlek 


at91sam9x5ek 


axxiaarm 


axxiapowerpc 


b4420qds 
b4420qds-64b 
b4860qds 
b4860qds-64b 
baldeagle 
balto 
balto-xip 
bananapi 
beagleboard 
beagleboard 
beaglebone 
beaglebone 
beaglebone 
ben-nanonote 
bsc9131rdb 
bsc9132qds 
bug 

bug20 
bytepanel 
c293pcie 
c7x0 


ccardimx28js 


描述 
Acer IconiaTab A500 


Sharp Zaurus SL-C1000 device 

TI AM180x EVM board 

TI AM335x EVM 

TI Sitara AM3517 EVM 

TI AM37x EVM 

TI AM437x EVM 

TI DRA7xx EVM 

Toradex Apalis iMX6 SOM 

Unified/fake Arago machine configuration for Tl/Arago ARMv5 platforms 
Unified/fake Arago machine configuration for Tl/Arago ARMv5 platforms 
Unified/fake Arago machine configuration for TI/Arago ARMv7 platforms 
Arndale board 

Arndale Octa board 

Arria 10 SoC 

Arria V SoC 

Atmel evaluation board 

Atmel evaluation board 

Atmel evaluation board 

LSI Axxia ARM systems 


LSI Axxia PowerPC systems 


Freescale QorlQ Qonverge B4420 

Freescale QorlQ Qonverge B4420 

Freescale QorlQ Qonverge B4860 

Freescale QorlQ Qonverge B4860 

Bald Eagle systems 

Balto Board RZ/A1H 

Balto Board RZ/A1H 

Banana Pi, based on Allwinner A20 CPU (http://bananapi.org) 
BeagleBoard board (http://beagleboard.org) 

BeagleBoard board 

BeagleBone board (http://beagleboard.org/bone) 
BeagleBone and BeagleBone Black boards (http://beagleboard.org/black) 
BeagleBone board 

Qi-Hardware Ben Nanonote 

Freescale QorlQ Qonverge BSC9131 

Freescale QorlQ Qonverge BSC9132 

BUG 1.x board (imx31 based) 

BUG 2.0 board (OMAP3530 based) 

bytePANEL by bytes at work AG 


Freescale C29x Crypto Coprocessor 


Sharp Zaurus SL-C700, Sharp Zaurus SL-C750, Sharp Zaurus SL-C760, Sharp Zaurus SL-C860 


devices 


Digi ConnectCore for MX28 JSK 


层 
meta-acer 
meta-handheld 
meta-ti 
meta-ti 
meta-ti 
meta-ti 
meta-ti 
meta-ti 
meta-fsl-arm-extra 
meta-arago-distro 
meta-arago-distro 
meta-arago-distro 
meta-exynos 
meta-exynos 
meta-altera 
meta-altera 
meta-atmel 
meta-atmel 
meta-atmel 
meta-lsi 


meta-lsi 


meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-baldeagle 
meta-renesas-rzal 
meta-renesas-rzal 
meta-sunxi 
meta-ti 
meta-yocto-bsp-old 
meta-ti 
meta-yocto-bsp 
meta-beagleboard 
meta-handheld 
meta-fsl-ppc 
meta-fsl-ppc 
meta-bug 
meta-bug 
meta-bytesatwork 
meta-fsl-ppc 
meta-handheld 


meta-digi-arm 


机 器 名 


ccimx51js 
ccimx53js 
cfa10036 
cfa10037 
cfa10049 
cfa10055 
cfa10056 
cfa10057 
cfa10058 
cgtqmx6 
chip 
chromebook-snow 
ci20 

cm-fx6 
colibri-imx6 
colibri-vf 
collie 
creator-ci20 
crespo 
crownbay-noemgd 
crystalforest 


cubieboard 


cubieboard2 
cubietruck 
cubox 

cubox-i 
cyclone5 
dra7xx-evm 
dra/7xx-evm 
duovero 
edgerouter 
edison 
efikamx 
emenlow-noemgd 
ep108-zynqmp 
ettus-e1xx 
ettus-e300 
example 
forfun-q88db 
fri2-noemgd 
gcwO 
geeksphone-one 
generic-armv4t 


generic-armv5te 


Digi ConnectCore for MX51 JSK 

Digi ConnectCore for MX53 JSK 

CFA-10036 

CFA-10037 

CFA-10049 

CFA-10055 

CFA-10056 

CFA-10057, also called CFA-920 

CFA-10058, also called CFA-921 

Congatec QMX6 evaluation board 

CHIP board 

Arndale board 

ci20 systems 

CompuLab CM-FX6 machines 

Toradex Colibri iMX6 SOM 

Toradex Colibri VF50/VF61 powered by Freescale Vybrid SoC 
SA1100 based Sharp Zaurus SL-5000 and SL-5500 devices 
MIPS Creator Cl20 

Samsung Crespo 

Crown Bay systems, without Intel-proprietary graphics bits 
Crystal Forest Gladden systems 


Cubieboard, based on Allwinner a10 CPU (http://cubieboard.org) 


Cubieboard2, based on Allwinner A20 CPU 

Cubietruck, based on Allwinner A20 CPU (www.cubietruck.com) 
www.solid-run.com/products/cubox 

SolidRun CuBox-i and HummingBoard machines 

Cyclone V SoC 

TI DRA7xx EVM 

TI DRA7xx EVM 

Gumstix DuoVero 

Edgerouter 


Edison systems 


EFIKA MX development platform (www.powerdeveloper.org/platforms/efikamx) 


eMenlow-based systems, such as the Webs-2120 box, without the Intel-proprietary graphics bits 


Xilinx EP108 ZynqMP emulation platform 
USRP E1XX 
Ettus Research E3XX SDR 


Forfun Q88DB tablet with A13 CPU 


Fish River Island 2 systems, without Intel-proprietary graphics bits 


Game Consoles Worldwide (GCW) Zero 
Geeksphone One 

ARMv4T-based boards 
ARMv5TE-based boards 


meta-digi-arm 
meta-digi-arm 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-chip 
meta-exynos 
meta-ci20 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-handheld 
meta-jz-mips 
meta-samsung 
meta-crownbay 
meta-crystalforest 


meta-sunxi 


meta-sunxi 
meta-sunxi 
meta-cubox 
meta-fsl-arm-extra 
meta-altera 
meta-ti 
meta-dra7xx-evm 
meta-gumstix 
meta-yocto-bsp 
meta-intel-edison-bsp 
meta-efikamx 
meta-emenlow 
meta-xilinx 
e100-bsp 
e300-bsp 
meta-kernel-dev 
meta-sunxi 
meta-fri2 
meta-handheld 
meta-geeksphone 
meta-eldk 
meta-eldk 


机 器 名 


generic-armv6 
generic-armv/a 
generic-armv/a-hf 
generic-mips 
generic-nios2 
generic-powerpc 


generic-powerpc-4xx 


generic-powerpc-4xx- 


softfloat 


generic-powerpc-e500v2 


generic-powerpc-softfloat 


genericarmv/a 
genericarmv/ab 
genericarmv8 
genericarmv8b 


genericx86 


genericx86-64 


grouper 
guruplug 
h1940 
h3600 


hpveer 
htcdream 
htcleo 
hx4700 
i9300 
igep0020 
igep0030 
igep0033 


imx233-olinuxino-maxi 
imx233-olinuxino-micro 
imx233-olinuxino-mini 


imx233-olinuxino-nano 


imx23evk 
imx28evk 
imx51evk 
imx53ard 
imx53qsb 
imx6dl-riotboard 
imx6dlsabreauto 
imx6dlsabresd 


imx6qpsabreauto 


Freescale i.MX6Q SABRE Automotive 


imx6qsabreauto 


ARMv6-based boards 

ARMv/a-based boards 

ARMv7a-based boards 

MIPS-based boards 

Nios Il machines 

Generic PowerPC machine with FPU 

APM PPC4xx-based boards (with FPU) 
APM PPC4xx-based boards (without FPU) 


Generic PowerPC machine without FPU 

Generic machine to be used by linaro-media-create 
Generic machine to be used by linaro-media-create 
Generic machine to be used by linaro-media-create 


Generic machine to be used by linaro-media-create 


Generic X86 (32-bit) PCs; Supports moderately wide range of drivers that should boot and be 
usable on typical hardware 


generic X86_64 (64-bit) PCs and servers; supports moderately wide range of drivers that should 
boot and be usable on typical hardware 


Asus Grouper 

ARM-based Marvell SheevaPlug 

HP iPAQ h1930 and hi940 

Compaq iPAQ 36xx, Compaq iPAQ 37xx, and Compaq iPAQ 38xx devices 


HP Veer handset 

HTC Dream phone (aka T-Mobile G1 and Google ADP-1) 
HTC Leo smartphone (aka HTC HD2) 
hx4700 iPAQ with a PXA27x CPU 

Samsung Galaxy SIII 

IGEPv2 AM/DM37x processor board 

IGEP COM module AM/DM37x processor board 
IGEP COM AQUILA AM335x processor board 
OLIMEX iMX233-OLinuXino-Maxi 

OLIMEX iMX233-OLinuXino-Micro 

OLIMEX iMX233-OLinuXino-Mini 

OLIMEX iMX233-OLinuXino-Nano 

Freescale i.MX23 Evaluation Kit (EVK) 
Freescale i.MX28 EVK 

Freescale i.MX51 EVK 

Freescale i.MX53 SABRE Automotive Board 
Freescale i.MX53 Quick Start Board 

i.MX6S RloTboard 

Freescale i.MX6DL SABRE Automotive 
Freescale i.MX6DL SABRE Smart Device 
Freescale i.MX6QP SABRE Automotive 


meta-eldk 
meta-eldk 
meta-eldk 
meta-eldk 
meta-altera 
meta-eldk 
meta-eldk 
meta-eldk 


meta-eldk 
meta-eldk 
meta-linaro 
meta-linaro 
meta-aarch64 
meta-aarch64 


meta-yocto-bsp 


meta-yocto-bsp 


meta-asus 

meta-kirkwood 
meta-handheld 
meta-handheld 


meta-palm 
meta-htc 
meta-htc 
meta-handheld 
meta-samsung 
meta-igep 
meta-igep 


meta-igep 


meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 


meta-fsl-arm-extra 


meta-fsl-arm 
meta-fsl-arm 
meta-fsl-arm 
meta-fsl-arm 


meta-fsl-arm 


meta-fsl-arm-extra 


meta-fsl-arm 
meta-fsl-arm 
meta-fsl-arm 


meta-fsl-arm 


续 


机 器 名 


imx6qsabrelite 
imx6qsabresd 
imx6qvab820 
imx6sl-warp 
imx6slevk 
imx6solosabreauto 
imx6solosabresd 
imx6sxsabreauto 
imx6sxsabresd 
imx6ulevk 
imx/dsabresd 


intel-core2-32 


intel-corei7-64 


intel-quark 
jasperforest 
k2e-evm 
k2g-evm 
k2hk-evm 
k2l-evm 


kc705-trd-microblazeel 


Ing-rt-x86-64 
Ing-x86-64 
Is1021atwr 
m28evk 
m28evk 
m53evk 
m53evk 
maguro 

mele 

meleg 
microzed-zynq/ 
microzed-zynq/ 


minnow 


minnow-emgd 


ml405-virtex4-ppc405 
m1507-virtex5-ppc440 
mpc5200 
mpc5200xenomai 
mpc8315e-rdb 

nanopi 


netbookpro 


Psion Teklogix NetBook Pro 


Boundary Devices i.MX6Q SABRE Lite 
Freescale i.MX6Q SABRE Smart Device 
VAB-820 

i. MX6SL WaRP board 

Freescale i.MX6SL EVK 

Freescale i.MX6Solo SABRE Automotive 
Freescale i.MX6Solo SABRE Smart Device 
Freescale i.MX6SoloX Sabre Automotive 
Freescale i.MX6SoloX Sabre Smart Device 
Freescale i.MX6UL EVK 

Freescale i.MX7D SABRE Smart Device 


32-bit Intel Core 2 CPU (and later) with MMX, SSE, SSE2, SSE3, and SSSE3 instruction set 
support; supports moderately wide range of drivers that should boot and be usable on typical 
hardware 


64-bit Intel Core i7 CPU (and later) with MMX, SSE, SSE2, SSE3, and SSSE3 instruction set 
support; supports moderately wide range of drivers that should boot and be usable on typical 
hardware 


Quark systems 

Jasper Forest Picket Post 

TI Keystone 2 K2E Evaluation Module (EVM) 
TI Keystone 2 K2G EVM 

TI Keystone 2 K2HK EVM 

TI Keystone 2 K2L EVM 


Machine support for Xilinx KC705 Embedded Kit targeted reference design (TRD) 


LS1021ATWR in 32-bit mode 

DENX M28 SoM EVK 

DENX M28 SoM EVK 

DENX M53 SoM EVK 

DENX M53 SoM EVK 

Samsung Tuna 

Mele a1000 and a2000, based on Allwinner a10 CPU 
Mele a1000g and a2000g, based on Allwinner a10 CPU 
Machine support for microZed (www.microzed.org) 
Machine support for microZed (www.microzed.org) 


MinnowBoard v1 (Intel Atom E640T); for the MinnowBoard MAX (Intel Atom E38xx), use the 
meta-intel intel-corei7-64 BSP (www.elinux.org /Minnowboard:MinnowMaxYoctoProject) 


MinnowBoard v1 (Intel Atom E640T); for the MinnowBoard MAX (Intel Atom E38xx), use the 
meta-intel intel-corei7-64 BSP (www.elinux.org/Minnowboard:MinnowMaxYoctoProject) 


Xilinx ML405 FPGA development platform with a Virtex-4 PowerPC 405 processor (with APU FPU) 
Xilinx ML507 FPGA development platform with a Virtex-5 PowerPC 440 processor (with APU FPU) 


FriendlyARM NanoPi board 


meta-fsl-arm-extra 
meta-fsl-arm 
meta-via-vab820-bsp 
meta-fsl-arm-extra 
meta-fsl-arm 
meta-fsl-arm 
meta-fsl-arm 
meta-fsl-arm 
meta-fsl-arm 
meta-fsl-arm 
meta-fsl-arm 


meta-intel 


meta-intel 


meta-intel 
meta-jasperforest 
meta-ti 

meta-ti 

meta-ti 

meta-ti 


meta-xilinx 


meta-linaro 
meta-linaro 
meta-fsl-arm 
meta-eldk 
meta-fsl-arm-extra 
meta-eldk 
meta-fsl-arm-extra 
meta-samsung 
meta-sunxi 
meta-sunxi 
meta-xilinx-community 
meta-xilinx 


meta-minnow 


meta-minnow 


meta-xilinx-community 
meta-xilinx-community 
meta-eldk 
meta-eldk 
meta-yocto-bsp 
meta-nanopi 


meta-netbookpro 


机 器 名 


netstora 
nexusone 
nitrogen6sx 
nitrogen6x 
nitrogen6x-lite 
nokia900 
nslu2be 

nslu2le 

nuc 

odroid-c1 
odroid-u2 
odroid-ux3 
odroid-xu 
olinuxino-a10lime 
olinuxino-a10s 
olinuxino-a13 
olinuxino-a13som 
olinuxino-a20 


olinuxino-a20lime 


olinuxino-a20lime2 


olinuxino-a20som 


om-gta01 


om-gta02 
om-gta04 
omap3evm 
omap5-evm 
openpandora 
ouya 

overo 

overo 
p1010rdb 
p1020rdb 
p1021rdb 
p1022ds 
p1023rdb 
p1025twr 
p2020rdb 
p2041rdb 
p3041ds 
p4080ds 
p5020ds 
p5020ds-64b 
p5040ds 
p5040ds-64b 


描述 
ARM-based Netgear Stora 


Nexus One smartphone 

Boundary Devices Nitrogen6SX 

Boundary Devices Nitrogen6X 

Boundary Devices Nitrogen6xX Lite 

Nokia 900 

NSLU2 in big-endian mode 

NSLU2 in little-endian mode 

Intel NUC model DC32171YE 

ODROID-C1 by Hardkernel 

ODROID-U2 by Hardkernel 

ODROID-UX3 systems 

ODROID-XU by Hardkernel 

Olimex A10-OLinuXino Lime Board, based on Allwinner A10 CPU 
Olimex A10S-OLinuXino-MICRO Board, based on Allwinner ALOs CPU 
Olime A13-OLinuXino Board, based on Allwinner a13 CPU 
Olimex A13-SOM Evaluation Board, based on Allwinner A13 CPU 
Olimex A20-OLinuXino Board, based on Allwinner A20 CPU 
Olimex A20-OLinuXino Lime Board, based on Allwinner A20 CPU 
Olimex A20-OLinuXino Lime2 Board, based on Allwinner A20 CPU 
Olimex A20-SOM Evaluation Board, based on Allwinner A20 CPU 
OM Neo1973 GSM phone 


Openmoko NeoFreerunner GSM phone 
Goldelico GTAO4 GSM phone 

Texas Instruments OMAP3 EVM 
Texas Instruments OMAP5 uEVM 
Pandora handheld console (www.openpandora.org) 
ASUS tf201 

Gumstix Overo 

Gumstix Overo 

Freescale QorlQ P1010 Reference 
Freescale QorlQ P1020 Reference 
Freescale QorlQ P1021 Reference 
Freescale QorlQ P1022 Development 
Freescale QorlQ P1023 Reference 
Freescale QorlQ P1025 MPU Tower 
Freescale QorlQ P2020 Reference 
Freescale QorlQ P2041 Reference 
Freescale QorlQ P3041 Development 
Freescale QorlQ P4080 Development 
Freescale QorlQ P5020 Development 
Freescale QorlQ P5020 Development 
Freescale QorlQ P5040 Development 
Freescale QorlQ P5040 Development 


Z 
meta-kirkwood 
meta-htc 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-nokia 
meta-nslu2 
meta-nslu2 
meta-nuc 
meta-odroid 
meta-odroid 
meta-odroid 
meta-odroid 
meta-sunxi 
meta-sunxi 
meta-sunxi 
meta-sunxi 
meta-sunxi 
meta-sunxi 
meta-sunxi 
meta-sunxi 


meta-openmoko 


meta-openmoko 
meta-openmoko 
meta-ti 

meta-ti 
meta-openpandora 
meta-ouya 


meta-gumstix 


meta-gumstix-community 


meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 


机 器 名 


palmpre 
palmpre2 
pandaboard 
parallella 
parallella-hdmi 
pem052 
pepper 
picosam9 
picozed-zynq/7/ 
poodle 
qemuarm 
qemuarm64 
qemumicroblaze 


qemumicroblaze- 
s3adsp1800 


qemumips 
qemumips64 
qemuppc 
qemuppc64 
qemux86 
qemux86-64 
qemuzynq 


quark 


raspberrypi 
raspberrypiO 


raspberrypi2 


rk3066a-marsboard 


rk3188-radxarock 


rk3288-firefly 


romley 

romley-ivb 
routerstationpro 
rskrza1 
rskrza1-xip 
sama5d2-xplained 
sama5d3-xplained 
sama5d3xek 
sama5d4-xplained 
samabd4ek 
sheevaplug 

spitz 

sugarbay 
t1023rdb 
t1023rdb-64b 


Palm Pre handset 

Palm Pre 2 handset 

OMAP4430 Panda 

Adapteva Parallella Board, headless 

Adapteva Parallella Board with HDMI support 

Phytec phyCORE Vybrid Development Kit 

Gumstix Pepper 

Picosam9 board (http://arm.mini-box.com) 

Machine support for picoZed (http://zedboard.org/product/picozed) 
PXA250 based Sharp Zaurus SL-B500 and SHarp Zaurus SL-5600 devices 
arm_versatile_926ejs 

Generic ARMv8 

MicroBlaze QEMU machine support (Petalogix-ml605 model) 
MicroBlaze QEMU machine support (Petalogix-s3adsp1800 model) 


mti_malta32_be 

mti-malta64-be 

PPC system under QEMU emulation 

PPC system under QEMU emulation 

Common x86 

Common x86 

Zynq QEMU machine support (xilinx-zyngq-a9 model) 


Quark systems 


RaspberryPi board (www.raspberrypi.org) 


RaspberryPi Zero board (https://www.raspberrypi.org/blog /raspberry-pi-zero) 


RaspberryPi 2 


The Marsboard-RK3066 is powered by the popular Rockchip dual-core SoC combining a power 


dual-core ARM Cortex-A9 CPU and quad-core Mali-400 MP4 GPU 


Radxa Rock is a single-board computer with quad-core ARM Cortex-A9 processor, 80 pin 


headers, which makes it easy to connect other I/O or GPIO 


Firefly-RK3288 is a high-performance platform with strong computing power, graphic processing, 


and video decoding ability 
Romley systems 

Romley systems 

mti_malta32_be 

RSKRZA1 board 

RSKRZA1 board 

Atmel evaluation board 

Atmel evaluation board 

Atmel evaluation board 

Atmel evaluation board 

Atmel evaluation board 
ARM-based Marvell SheevaPlug 
Sharp Zaurus SL-C3000 device 
Sugar Bay systems 

Freescale QorlQ T1023 Reference 
Freescale QorlQ T1023 Reference 


meta-palm 
meta-palm 

meta-ti 
meta-parallella 
meta-parallella 
meta-fsl-arm-extra 
meta-gumstix 
meta-picosam9 
meta-xilinx 
meta-handheld 
openembedded-core 
openembedded-core 
meta-xilinx 


meta-xilinx 


openembedded-core 
openembedded-core 
openembedded-core 
meta-qemu-bsps 
openembedded-core 
openembedded-core 
meta-xilinx 


meta-intel-quark 


meta-raspberrypi 
meta-raspberrypi 
meta-raspberrypi 


meta-rockchip 


meta-rockchip 


meta-rockchip 


meta-romley 
meta-romley 
meta-yocto-bsp-old 
meta-renesas-rzal 
meta-renesas-rzal 
meta-atmel 
meta-atmel 
meta-atmel 
meta-atmel 
meta-atmel 
meta-kirkwood 
meta-handheld 
meta-sugarbay 
meta-fsl-ppc 
meta-fsl-ppc 


机 器 名 
t1024rdb 


t1024rdb-64b 
t1040d4rdb 
t1040d4rdb-64b 
t1042d4rdb 
t1042d4rdb-64b 
t2080qds 
t2080qds-64b 
t2080rdb 
t2080rdb-64b 
t4160qds 
t4160qds-64b 
t4240qds 
t4240qds-64b 
t4240rdb 
t4240rdb-64b 
tilapia 

toro 

toroplus 

tosa 
twr-vf65gs10 
tx6q-10x0 


tx6q-11x0 
tx6s-8034 
tx6s-8035 
tx6u-8033 
tx6u-80x0 
tx6u-81x0 
ventana 
vexpressa9 
veyron-speedy 


wandboard 


zc702-base-trd-zynq7 


zc702-zynq7 


zc706-pcie-trd-zynq7 


zc/06-zynq/ 
ze/000-zynq/ 
zedboard-zynq/ 
Zx3-pm3-zynq7 
zybo-zynq7 
zynq-ze7000 


zynq-zx3-pm3 


zynq-zx3-starter 


Freescale QorlQ T1024 Reference 
Freescale QorlQ T1024 Reference 
Freescale QorlQ T1040D4 Reference 
Freescale QorlQ T1040D4 Reference 
Freescale QorlQ T1042D4 Reference 
Freescale QorlQ T1042D4 Reference 
Freescale QorlQ T2080 Development 
Freescale QorlQ T2080 Development 
Freescale QorlQ T2080 Reference 
Freescale QorlQ T2080 Reference 
Freescale QorlQ T4160 Development 
Freescale QorlQ T4160 Development 
Freescale QorlQ T4240 Development 
Freescale QorlQ T4240 Development 
Freescale QorlQ T4240 Reference 
Freescale QorlQ T4240 Reference 
Asus Tilapia 

Samsung Toro 

Samsung Toro Plus 

PXA255-based Sharp Zaurus SL-6000 device 
Freescale Vybrid TWR-VF65GS10 


Ka-Ro electronics TX6Q Computer-On-Module 


Ka-Ro electronics TX6Q Computer-On-Module 
Ka-Ro electronics TX6S Computer-On-Module 
Ka-Ro electronics TX6S Computer-On-Module 
Ka-Ro electronics TX6DL Computer-On-Module 
Ka-Ro electronics TX6DL Computer-On-Module 
Ka-Ro electronics TX6DL Computer-On-Module 
Gateworks Ventana boards 


VExpress A9 board 


Google Veyron Speedy Rev 1+ board (formally known as Chromebook Asus C201) 


i.MX6 Wandboard Quad 

Machine support for ZC702 Base TRD 
Machine support for ZC702 Evaluation Board 
Machine support for ZC706 PCle TRD 


Machine support for ZC706 Evaluation Board 


Machine configuration for the ze7000 from NetModule device 


Bs 


Machine support for ZedBoard (www.zedboard.org) 


Enclustra PM3 evaluation board with ZX3 module 


Machine support for ZYBO 


Poky image generated by NetModule AG (www.netmodule.com) for the ZE7000 (Z4E) Platform 


Poky image generated by NetModule AG (www.netmodule.com) for the Mars ZX3 Module + Mars 
PM3 development kit from Enclustra AG (www.enclustra.com) 


Poky image generated by NetModule AG (www.netmodule.com) for the Mars ZX3 Module + Mars 
Starter development kit from Enclustra AG (www.enclustra.com) 


meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-fsl-ppc 
meta-asus 
meta-samsung 
meta-samsung 
meta-handheld 
meta-fsl-arm 


meta-fsl-arm-extra 


meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-fsl-arm-extra 
meta-ivi-bsp 
meta-rockchip 
meta-fsl-arm-extra 
meta-xilinx-community 
meta-xilinx 
meta-xilinx-community 
meta-xilinx 
meta-xilinx-community 
meta-xilinx 
meta-xilinx-community 
meta-xilinx 
meta-netmodule 


meta-netmodule 


meta-netmodule 


